5. GetHotels

Version 9.1 by Giorgi Mdivnishvili on 2023/12/26 10:45

Method Description

The GetHotels method is used to retrieve a list of hotels by country.
In order to be able to retrieve a list of hotels in United Arab Emirates, for example, you need to pass the country code "AE" as a parameter.

Endpoint URL - [GET]

Request Parameters

Request Body

none

Response Body

[
  {
   "hotelCode": "string",
   "hotelName": "string",
   "hotelClass": "string",
   "cityUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
   "countryCode": "string",
   "countryName": "string",
   "districtUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
   "cityName": "string",
   "districtName": "string",
   "hotelType": "CityHotel",
   "latitude": "string",
   "longitude": "string",
   "hasAlcohol": true,
   "hasFreeWifi": true,
   "hasMetro": true,
   "hasPool": true,
   "hasMall": true
  }
]

example

{
       "hotelCode": "cfbca5b5-4090-4bcd-805a-463d83423b86",
       "hotelName": "Ramada Abu Dhabi Corniche",
       "hotelClass": "4",
       "cityUID": "28c794fe-3c7e-4da2-ba93-f24bd3d4730d",
       "countryCode": "AE",
       "districtUID": "ee402984-6d1d-4fcf-915d-f31b14fa8b0f",
       "cityName": "Abu Dhabi",
       "districtName": "Abu Dhabi",
       "hotelType": "CityHotel",
       "latitude": "24.503759",
       "longitude": "54.374577",
       "hasAlcohol": false,
       "hasFreeWifi": true,
       "hasMetro": false,
       "hasPool": true,
       "hasMall": false
    },
    {
       "hotelCode": "c64b6082-2337-4519-8c33-4bcdef76b16b",
       "hotelName": "Emirates Palace Mandarin Oriental, Abu Dhabi",
       "hotelClass": "5",
       "cityUID": "28c794fe-3c7e-4da2-ba93-f24bd3d4730d",
       "countryCode": "AE",
       "districtUID": "ee402984-6d1d-4fcf-915d-f31b14fa8b0f",
       "cityName": "Abu Dhabi",
       "districtName": "Abu Dhabi",
       "hotelType": "BeachHotel",
       "latitude": "24.461556",
       "longitude": "54.317404",
       "hasAlcohol": false,
       "hasFreeWifi": true,
       "hasMetro": false,
       "hasPool": true,
       "hasMall": false
    },

Schema

Success

[Hotel{

hotelCodestring
nullable: true
hotelNamestring
nullable: true
hotelClassstring
nullable: true
cityUIDstring($uuid)
nullable: true
countryCodestring
nullable: true
countryNamestring
nullable: true
districtUIDstring($uuid)
nullable: true
cityNamestring
nullable: true
districtNamestring
nullable: true
hotelTypeHotelTypeEnumstringEnum:
[ CityHotel, BeachHotel, SecondLineBeach ]
latitudestring
nullable: true
longitudestring
nullable: true
hasAlcoholboolean
hasFreeWifiboolean
hasMetroboolean
hasPoolboolean
hasMallboolean

}]

Definitions

hotelid: GUID of the hotel in the database. 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
districtUID: 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