X
Our new Developer Portal is here!
The latest version of our Demand API (V3.1) is now available.
Update now for improved functionality and access to newly added endpoints.
Take me there
V2 Availability Endpoints Best Practices
The technical documentation for the below endpoints is accessible when you have been granted access to one or both of them.
# /hotelAvailability
The **/hotelAvailability** endpoint returns our recommendations for the cheapest available room(s) for each property that match the user’s provided check-in and check-out dates, location, number of room(s) and number of guest(s).
See also the [**hotelAvailability flowchart**](https://www.lucidchart.com/publicSegments/view/739f691c-77d3-4115-9004-85756d2b13d9/image.png)
## /hotelAvailability Search Results - Best Practice
Search Results is the **/hotelAvailability** output that comprises a list of available properties.
**/hotelAvailability** returns the cheapest room(s) combination available, whereas **/blockAvailability** displays all the available room(s) in the requested property.
There are multiple options and variants to retrieve these search results. You can add the affiliate ID and the user platform into the request for tracking purposes. You can also add property-related information and filter the output accordingly.
We recommend using the city_ids input parameter for location in order to return a list of our recommended properties, without any filtering for this initial search.
Once you see the list of available properties, you have the following options.
* **Option 1**
Implement a filter to narrow down the results in accordance with your requirements.
You will land on the following pages:
Search results page (default) with:
-- Property brochure
-- Reservation process in combination with the block_id.
* **Option 2**
Display the property brochure on your site. For guidelines on using our static content, see [Permitted Use](https://developers.booking.com/api/commercial/index.html?page_url=permitted-use).
## Notes
* Although **/hotelAvailability** provides the converted price in another currency, we recommend displaying the price in the property’s local currency. If you cannot, please add a clear disclaimer on your site that explains that the property charges the total price in local currency.
* For technical details such as sample output for each feature, please see the [technical documentation](https://developers.booking.com/api/technical.html#!/Availability/hotelAvailability).
###### ---
## More Useful Information on /hotelAvailability
* When a user searches for multiple rooms and occupancies, the output might return room combinations that differ from what they specified in their initial request.
* Your account might be restricted to one or more of the output fields that you see available in the [technical documentation](https://developers.booking.com/api/technical.html#!/Availability/hotelAvailability). Contact your account manager if you wish to enable more output fields. If you are part of the self-managed partners programme, use the contact form in the Booking.com Partner Centre.
###### ---
# /blockAvailability
The **/blockAvailability** endpoint returns a list of all bookable rooms at a property. A room can have multiple blocks, as a block is a combination of the meal policy, cancellation policy, occupancy, and other factors. It is possible to search for multiple properties in one request, but less detail will be given. We instead recommend using **/hotelAvailability** for a multiple-property search.
See also the [**blockAvailability flowchart**](https://www.lucidchart.com/publicSegments/view/936c7d7e-06e6-44b8-83e2-579074763639/image.png)
## /blockAvailability Available Rooms - Best Practice
This endpoint replicates Booking.com’s property brochure particularly with special attention paid to the listing of available room(s).
**/hotelAvailability** returns the cheapest room(s) combination available, whereas **/blockAvailability** returns all available room(s) of the requested property.
Just like **/hotelAvailability**, **/blockAvailability** also features multiple options and variants to return a list of available room(s). You can add affiliate ID and the user platform into the request for tracking purposes. You can also filter the output.
We recommend you use **/blockAvailability** for the following purposes:
* To display a list of rooms available at a single property.
* In conjunction with the ‘extras’ parameter and ‘extra_charges’ input value. This will return a breakdown of the extra charges that might apply in addition to the room price. For more details on possible extra charges, see the [Possible Values](https://developers.booking.com/api/commercial/index.html?page_url=possible-values) page.
## Notes
* Although **/blockAvailability** provides the converted price in another currency, we recommend displaying the price in the property’s local currency. If you cannot, please add a clear disclaimer on your site that explains that the property charges the total price in local currency.
* See the steps to proceed to the reservation process on [How to Book](https://developers.booking.com/api/commercial/index.html?page_url=how-to-book).
* For technical details such as sample output for each feature, please see the [technical documentation](https://developers.booking.com/api/technical.html#!/Availability/blockAvailability).
###### ---
## More Useful Information on /blockAvailability
Your account might be restricted to one or more of the output fields that you see available in the [technical documentation](https://developers.booking.com/api/technical.html#!/Availability/hotelAvailability). Contact your account manager if you wish to enable more output fields. If you are part of the self-managed partners programme, use the contact form in the Booking.com Partner Centre.
###### ---
