5. GetHotels

Version 20.1 by Giorgi Mdivnishvili on 2024/04/11 13:26

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

Field NameData TypeDescription
hotelCodeStringUnique identifier for the hotel.
hotelNameStringThe name of the hotel.
hotelClassStringClassification of the hotel on a scale (e.g., "4" for 4-star).
cityUIDStringUnique identifier for the city where the hotel is located.
countryCodeStringThe ISO 3166-1 alpha-2 country code for the hotel's location.
districtUIDStringUnique identifier for the district where the hotel is located.
cityNameStringName of the city where the hotel is located.
districtNameStringName of the district where the hotel is situated.
hotelTypeStringType of hotel (e.g., "CityHotel", "BeachHotel").
latitudeStringGeographic latitude of the hotel.
longitudeStringGeographic longitude of the hotel.
hasAlcoholBooleanIndicates whether alcohol is served at the hotel.
hasFreeWifiBooleanIndicates whether free Wi-Fi is available.
hasMetroBooleanIndicates the proximity of a metro/subway station to the hotel.
hasPoolBooleanIndicates whether the hotel has a swimming pool.
hasMallBooleanIndicates the proximity of a shopping mall to the hotel.