0fbdc2f4423a
List available hotel rooms
This endpoint returns the cheapest available room for each hotel matching your check-in and check-out dates. You can search a specific list of up to 1000 hotels with hotel_ids, or an area with latitude, longitude and radius (the two are mutually exclusive). For each hotel you get whether the price includes breakfast or other meals and whether it can be cancelled for free. Request the room_details extra for a per-room price breakdown, and use add_filtered_rate/options to filter the results.
String enum values (such as user_platform, extras, options, add_filtered_rate, order_by and order_dir) are case-insensitive. language accepts the lowercase codes listed below.
Query parameters
The arrival date.
The departure date. Must be later than {checkin}. Must be between 1 and 30 days after {checkin}.
Guest country code (ISO 3166-1 alpha-2). Used to display the most accurate prices and price details for guests from that country.
Limit the result to up to 1000 specific hotels that have availability for the given guests and dates. Mutually exclusive with latitude/longitude: use either a hotel list or an area search, not both.
[ 96969 ]
Latitude for an area search, used together with longitude and radius. Requires longitude; cannot be combined with hotel_ids.
Longitude for an area search, used together with latitude and radius. Requires latitude; cannot be combined with hotel_ids.
Search radius in km around latitude/longitude. Only applies to an area search. Minimum and default 15, maximum 100.
Guests per room, as a comma-separated list: A for each adult and the age (0-17) for each child (e.g. A,A,5 = two adults and a 5-year-old). For multi-room searches, repeat the parameter per room as room1, room2, ... up to room30.
Splits a single guest group into this many rooms automatically. Only applied when exactly one room group is provided and the value is between 2 and the number of adults inclusive; larger values have no effect.
Return prices in this currency (ISO 4217 code).
The user's language.
The user's platform.
Genius loyalty level (0-3) used to include Genius rates the partner is eligible for. Defaults to 0 (no Genius rates).
The extra items for this request. See the documentation for more details about each extra.
The list of options to filter the results.
The list of rates to filter the results.
The way to order your results. When ordering by distance, make sure to specify latitude and longitude.
The direction you wish for your order_by parameter to be ordered in.
The maximum number of results to return.
Pagination token used to retrieve the next page of results. Obtained from next_page.
Headers
Response
OK
Example response
{
"result": [
{
"price": 100,
"net_price": 90,
"checkin_time": {
"from": "14:00",
"until": "23:00"
},
"cheapest_breakfast_rate": {
"price": 120,
"net_price": 110
},
"cheapest_filtered_rate": {
"price": 120,
"net_price": 110
}
}
]
}