Destinations

Get destination information (standard or detailed) by destination ancestor ID or country code.

This endpoint provides hierarchical destination data for hotel booking applications. You can retrieve destinations by either specifying a parent destination ID or a country code.

Query Methods:

By Parent Destination ID: Get all sub-destinations under a specific destination

Use parentDestinationId parameter

Returns immediate children of the specified destination

Useful for building location hierarchies (e.g., cities within a state)

By Country Code: Get all destinations within a specific country

Use countryCode parameter (ISO 3166-1 alpha-2 format, e.g., "US", "CN")

Returns top-level destinations for the specified country

parentDestinationId is ignored when countryCode is provided

Response Detail Levels:

standard (default): Basic destination metadata and hierarchy information

details: Includes coordinates and full hierarchical relationships

Common Use Cases:

Building location selection dropdowns in booking forms

Implementing progressive location disclosure (country → state → city)

Geographic search autocomplete functionality

Performance Notes:

Response is cached for optimal performance

Large countries may return many destinations; consider pagination for UI

curl --location --request POST 'https://api-test.hotelbyte.com/api/search/destinations' \ --header 'Client-Request-Timestamp;' \ --header 'IP;' \ --header 'Language;' \ --header 'Request-Id;' \ --header 'Trace-Id;' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data-raw '{ "countryCode": "AE", "parentDestinationId": "804028047", "include": "standard", "filterEmptyCities": true, "minHotelCount": 0 }'

{ "code": 0, "msg": "string", "data": { "destinations": [ { "id": "string", "type": 0, "name": { "en": "string", "zh": "string", "ar": "string" }, "nameFull": { "en": "string", "zh": "string", "ar": "string" }, "countryCode": "string", "coordinates": { "centerLat": 0, "centerLng": 0, "boundingPolygon": { "type": "string", "coordinates": [ { "lat": 0, "lng": 0 } ] } }, "extra": { "cityName": { "en": "string", "zh": "string", "ar": "string" }, "provinceName": { "en": "string", "zh": "string", "ar": "string" }, "continentName": { "en": "string", "zh": "string", "ar": "string" }, "hotelCount": 0 }, "countryName": { "en": "string", "zh": "string", "ar": "string" }, "destinationName": { "en": "string", "zh": "string", "ar": "string" }, "parentDestinationName": { "en": "string", "zh": "string", "ar": "string" }, "parentDestinationId": "string" } ] } }

Request

Responses