Countries

This method is used to obtain a COUNTRIES portfolio.

Countries Request

Endpoint

GET https://api.test.hotelbeds.com/transfer-cache-api/1.0/locations/countries?fields= {{FIELDS}} &language= {{LANG}} &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)
codes String (String) comma separated list of ISO 3166 (2 digit) country 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/countries?fields=ALL&language=en&codes=ES,US&offset=0&limit=10

 

Countries Response

The response of Countries provides is described here.

Response Parameters

Name Type Description
code String ISO 3166 (2 digit) Country code
name String Country name

Response JSON Example

[
    {
        "code": "ES",
        "name": "Spain"
    },
    {
        "code": "US",
        "name": "United States"
    }
]
Response (JSON): [ { code: (String) ISO 3166 (2 digit) Country code name: (String) Country name } ]

Docs Navigation