v1

latestOpenAPI 3.0.32026-07-26630183.2 KB

Availability

Detail

Returns live availability for a specific hotel.

get/hotels-api/availability/{hotel_id}

Path parameters

hotel_idstring required

Refers to the id of the hotel.

Query parameters

country_codestring

Refers to the country code, which must be filled with two alphabetical digits.

checkin_datestring date required

Refers to the hotel check-in date and must be in the format YYYY-MM-DD.

checkout_datestring date required

Refers to the hotel check-out date and must be in the format YYYY-MM-DD.

currencystring required

Refers to the currency, which must be filled with three alphabetical digits. (E.g. "USD", "ARS")

distributionstring required

Passenger distribution. Each room’s passengers should be written as number_of_adults-children_ages. Children-age goes up to 17 years old. Rooms should be separated by “!”. E.g.: Means room 1 with 2 adults and room 2 with 2 adults and a 10-year-old child.

roompack_idstring

specific roompack_id (obtained in previous step).

language'EN' | 'ES' | 'PT'

Refers to the language, which must be filled with two alphabetical digits.

ttlinteger

Maximum time allowed for the connection. Minimum = 3000 ms, Maximum = 6200 ms.

refundable_onlyboolean

If set to ‘true’, only refundable hotel rates will be quoted.

Response

Detailed availability for the hotel

idinteger