Skip to Content

5. GetHotels

Version 21.1 by Giorgi Mdivnishvili on 2024/04/11 13:30
Contents

 

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.

This method facilitates the retrieval of essential hotel data, which can be beneficial for subsequent search parameters. The following details are available:

  1. Hotel ID: A unique identifier for the hotel.
  2. Hotel Name: The name of the hotel.
  3. Hotel Classification: The hotel's classification on a scale (e.g., "4" for 4-star).
  4. City ID: Unique identifier for the city where the hotel is located.
  5. Country Code: The ISO 3166-1 alpha-2 country code for the hotel's location.
  6. District ID: Unique identifier for the district where the hotel is located.
  7. City Name: Name of the city where the hotel is located.
  8. District Name: Name of the district where the hotel is located.
  9. Hotel Type: Type of hotel (e.g., "CityHotel", "BeachHotel").
  10. Latitude: Geographic latitude of the hotel.
  11. Longitude: Geographic longitude of the hotel.
  12. Alcohol Availability: Indicates whether alcohol is served at the hotel.
  13. Wi-Fi Availability: Indicates whether free Wi-Fi is available.
  14. Metro/Subway Proximity: Indicates the proximity of a metro/subway station to the hotel.
  15. Swimming Pool Availability: Indicates whether the hotel has a swimming pool.
  16. Shopping Mall Proximity: Indicates the proximity of a shopping mall to the hotel.

Endpoint URL - [GET]

Information

https://integration.kazunion.com/api/Catalogue/GetHotels

Request Parameters

 

KeyValueRequest URL
CountryCodeAEhttps://integration.kazunion.com/api/Catalogue/GetHotels?countryCode=AE

 

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.