Destinations

This method is used to obtain a DESTINATIONS portfolio.

Destinations Request

Endpoint

GET https://api.test.hotelbeds.com/transfer-cache-api/1.0/locations/destinations?fields= {{FIELDS}} &language= {{LANG}} &countryCodes= {{COUNTRY}} &codes= {{CODES}} &offset= {{OFFSET}} &limit= {{LIMIT}}
TIMEOUT: 60 seconds

 

Request parameters

Name Type Description
fields String comma separated list of response fields to return (mandatory)
language String ISO 639-1 (2 digit) Language code (mandatory)
countryCode String ISO 3166 (2 digit) country code (optional)
codes String comma separated list of destination codes (optional)
offset int it's the position in the dataset of a particular record. By specifying offset, you retrieve a subset of records starting with the offset value (optional)
limit int allows you to set the number of objects returned in one page (optional)

Request Example

https://api.test.hotelbeds.com/transfer-cache-api/1.0/locations/destinations?fields=ALL&language=es&countryCodes=ES&codes=MAD,BCN,PMI

 

Destinations Response

The response of Destinations provides information of the available destinations.

Response Parameters

Name Type Description
code String Destination code (Atlas code)
name String Destination Name
countryCode String ISO 3166 (2 digit) country code
language String ISO 639-1 (2 digit) Language code

Response JSON Example

[
    {
        "code": "BCN",
        "name": "Barcelona",
        "countryCode": "ES",
        "language": "ENG"
    },
    {
        "code": "MAD",
        "name": "Madrid",
        "countryCode": "ES",
        "language": "ENG"
    },
    {
        "code": "PMI",
        "name": "Majorca",
        "countryCode": "ES",
        "language": "ENG"
    }
]

Docs Navigation