Detail

get

https://api-dev.despegar.com/v3/hotels-api/availability/{hotel_id}

Returns live availability for a specific hotel.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

ℹ️
For a detailed flow diagram of this service, see: Guides-Hotels

Penalty

The penalty may be applied in one of the following ways:
a) As a number of nights.
b) As a percentage.

The applicable penalty will be determined based on the information provided. If no penalty is specified for a given range, it will be considered that no penalty applies.

Path Params

hotel_id

string

required

Refers to the id of the hotel.

Query Params

country_code

string

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

checkin_date

date

required

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

checkout_date

date

required

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

currency

string

required

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

distribution

string

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_id

string

specific roompack_id (obtained in previous step).

language

string

enum

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

Allowed:

ttl

integer

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

refundable_only

boolean

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

Responses

200Detailed availability for the hotel

400Bad Request

401Unauthorized

403Forbidden

404Not Found

429Too Many Requests

500Internal Server Error