2. Get Hotels

Last modified by Giorgi Mdivnishvili on 2024/02/29 09:39

Contents

Method - Get Hotels
- Response example
- Description of Response parameters

Method - Get Hotels

endpoint - https://testapi.rustaronline.com/api/Hotels/GetHotels

Use this endpoint with Get function to take in response all the list of available hotels. please take in consideration that this method CAN BE USED WITH `ApiVersion` with the value `r1` ONLY! Get the list of our hotels in the old format

Response example

Example of the response looks like this:

{
   "Code": "00",
   "Message": "",
   "Timestamp": "2023-12-01T16:22:16.877779+04:00",
   "Version": "r1",
   "ResponseID": "77ee41d6-284f-41d1-bf89-2092e62f00b0",
   "Data": [
        {
           "hotelid": "e6cba477-db27-40f3-b713-5d4dd5aa572d",
           "hotelname": "25Hours Dubai One Central",
           "pricestatus": "ready",
           "cityid": "f5185fa3-3f56-44ed-bf6b-80386a33caa2",
           "cityname": "Dubai",
           "districtid": "1fa8bb75-707b-40e6-8212-f705eeeaa16b",
           "districtname": "Sheikh Zayed Road",
           "countrycode": "AE",
           "hasalcohol": true,
           "hasfreewifi": true,
           "hasmall": false,
           "hasmetro": false,
           "haspool": true,
           "hotelclass": "*****",
           "hoteltype": "City",
           "popular": false,
           "recommended": false
        },
        {
           "hotelid": "31c00d7f-5d43-4212-afe6-eaec5f2a38df",
           "hotelname": "72 Hotel",
           "pricestatus": "ready",
           "cityid": "f78ac3bc-f040-46d0-8319-2c52083080a6",
           "cityname": "Sharjah",
           "districtid": "7ac1bbc8-59ea-4977-b272-ed8553f94f9b",
           "districtname": "Sharjah",
           "countrycode": "AE",
           "hasalcohol": false,
           "hasfreewifi": true,
           "hasmall": false,
           "hasmetro": false,
           "haspool": true,
           "hotelclass": "*****",
           "hoteltype": "City",
           "popular": false,
           "recommended": false
        },
        {
           "hotelid": "aa16fe79-5cb0-403a-80ff-8e2fdf117afc",
           "hotelname": "Abar Hotel Apartments",
           "pricestatus": "ready",
           "cityid": "f5185fa3-3f56-44ed-bf6b-80386a33caa2",
           "cityname": "Dubai",
           "districtid": "8c32a538-629e-4b73-8f1f-b06b7ff4db81",
           "districtname": "Dubai Investments Park",
           "countrycode": "AE",
           "hasalcohol": false,
           "hasfreewifi": true,
           "hasmall": false,
           "hasmetro": false,
           "haspool": true,
           "hotelclass": "****",
           "hoteltype": "City",
           "popular": false,
           "recommended": false
        },
        {
           "hotelid": "d1a7c40b-c63b-4445-b107-252fa12b7223",
           "hotelname": "Abidos Hotel Apartments Dubailand",
           "pricestatus": "ready",
           "cityid": "f5185fa3-3f56-44ed-bf6b-80386a33caa2",
           "cityname": "Dubai",
           "districtid": "b5e176d6-b990-48e3-8366-e3fe5ee9e55c",
           "districtname": "Dubailand",
           "countrycode": "AE",
           "hasalcohol": false,
           "hasfreewifi": true,
           "hasmall": false,
           "hasmetro": false,
           "haspool": true,
           "hotelclass": "Apartments",
           "hoteltype": "City",
           "popular": false,
           "recommended": false
        },

Description of Response parameters

The method returns the list of hotels with the statuses and timestamps of the prices

Value	Description
hotelid	GUID of the hotel in the database of Rustar. This GUID will be used to retrieve additional information (like prices) about the hotel
hotelname	string. Name of the hotel
pricestatus	string. "ready" or "pending". “ready” means that prices are ready to be downloaded. “pending” means that price registration is under processing and not all prices are available for the hotel. In case of “pending” the prices should be downloaded later when the status is changed to “ready”.
cityid	GUID of the City where the hotel is located.
cityname	string. Name of the city
districtid	GUID of the district, where the hotel is located
districtname	string. Name of the district
hasalcohol	Boolean parameter. Describes whether hotel serves alcohol or not
hasfreewifi	Boolean parameter. Describes whether free wifi is available in the rooms
hasmall	Boolean parameter. Describes whether there is a shopping mall near the hotel
hasmetro	Boolean parameter. Describes whether there is a metro station near the hotel
haspool	Boolean parameter. Describes whether there is swimming pool in the hotel
hotelclass	string. “”,””,””,””,”***” or ”Apartments”. Number of stars or Apartment hotel
hoteltype	string. "City" or “Beach”. Describes whether this hotel is located in the city or at the beach
popular	Boolean. Describes if the hotel was popular last 7 days
recommended	Boolean. True if the hotel is recommended by Rustar
note	string. Free formed text