Hotels

This method is used to obtain a HOTELS portfolio.

Hotels Request

Endpoint

GET https://api.test.hotelbeds.com/transfer-cache-api/1.0/hotels?fields= {{FIELDS}} &language= {{LANG}} &countryCodes= {{COUNTRIES}} &destinationCodes= {{DESTINATIONS}} &codes= {{CODES}} &giataCodes= {{GIATAS}} &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)
countryCodes String Comma separated ISO 3166 (2 digit) country codes (optional)
destinationCodes String Comma separated list of ATLAS destination codes (optional)
codes String Comma separated list of ATLAS hotel codes (optional)
giataCodes String Comma-separated list of GIATA hotel 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/hotels?fields=ALL&language=es&countryCodes=ES&destinationCodes=PMI&codes=1523

 

Hotels Response

The response of Hotels provides information of the hotels

Response Parameters

Name Type Description
code String Hotel code (Atlas code)
name String Hotel Name
category String Hotel Category name
description String Hotel description
countryCode String ISO 3166 (2 digit) country code
destinationCode String Atlas destination code
city String City name
coordinates Element latitude & longitude coordinates for the hotel
coordinates/latitude Float Latitude data for geolocation
coordinates/longitude Float Longitude data for geolocation
address String Hotel address
postalCode String Hotel postal code
terminals Array of String List of nearby terminals

Response JSON Example

[
    {
        "code": "1523",
        "name": "Visit Hotel Alexandra",
        "category": "4EST",
        "description": "Este moderno hotel está situado en Can Pastilla, en la Playa de Palma, y ofrece vistas hacia el puerto deportivo y al mar Mediterráneo. En las inmediaciones, los huéspedes encontrarán la interminable playa de arena local, numerosas tiendas, restaurantes, bares y cafeterías. El Acuario de Palma, con el tanque de tiburón más grande de Europa, se encuentra a poca distancia. Sin duda, un lugar perfecto para disfrutar unos días de relax cerca del mar.",
        "countryCode": "ES",
        "destinationCode": "PMI",
        "city": "CAN PASTILLA",
        "coordinates": {
            "latitude": 39.5362,
            "longitude": 2.71746
        },
        "address": "DELS PINS,15  ",
        "postalCode": "07610",
        "terminals": []
    }
]

Docs Navigation