Documentation

Destinations

This method is used to obtain a DESTINATIONS portfolio.

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

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.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 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"
    }
]