Skip to main content

Destinations Catalog

The destinations endpoint provides access to destination catalog data including cities, regions, airports, and their hierarchical relationships.

Endpoint​

POST /content/hotels/v1/destinations

Use Cases​

Get Destination Details​

{
  "query": {
    "destinationCodes": ["BCN"]
  }
}

List Destinations​

{
  "query": {
    "maxSize": 100
  }
}

Response Structure​

{
  "destinations": {
    "destinations": [
      {
        "code": "BCN",
        "name": "Barcelona",
        "type": "city",
        "location": {
          "city": "Barcelona",
          "countryCode": "ES",
          "latitude": 41.3851,
          "longitude": 2.1734
        },
        "parent": "ES",
        "children": ["BCN-AIRPORT"],
        "texts": [
          {
            "text": "Barcelona is a vibrant city in Catalonia",
            "languageCode": "en"
          }
        ]
      }
    ],
    "count": 1,
    "token": null
  }
}

Key Fields​

  • code - Destination code (use in search)
  • name - Destination name
  • type - Destination type (city, region, airport, etc.)
  • location - Geographic location
  • parent - Parent destination code
  • children - Child destination codes
  • texts - Multi-language descriptions

Destination Hierarchy​

Destinations form a hierarchy:

Country (ES)
  └── Region (Catalonia)
      └── City (BCN)
          └── Airport (BCN-AIRPORT)

Use this hierarchy to build location selectors in your UI.

Next Steps​