V2 Availability Endpoints Best Practices

The technical documentation for following endpoints are accessible when you have access to one or both of them. # hotelAvailability See also [**hotelAvailability flowchart**](https://www.lucidchart.com/publicSegments/view/739f691c-77d3-4115-9004-85756d2b13d9/image.png) **hotelAvailability** endpoint returns our recommendations of the cheapest available room(s) for each property. They match the combinations of check-in and check-out dates, location, number of room(s) and guest(s). ## 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 the **blockAvailability** gives you all available room(s) of the requested property. There are multiple options and variants to get the 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. We recommend to use the `city_ids` input parameter for the location to get the list of our recommended properties, without any filtering for this initial search. You see a 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 land on one of 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 a guideline to use 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 to another currency, we recommend to display the property’s local currency. If you cannot, add a clear disclaimer on your site that explains that the property charge the total price in local currency. * For technical details such as sample output for each feature, see the [technical documentation](https://developers.booking.com/api/technical.html#!/Availability/hotelAvailability).   ## hotelAvailability ~ Good to Know * When the user searches for multiple rooms and occupancies, the output might return room combinations that differ from what they specified in the request. * Your account might be restricted to one or more 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 are part of the self-managed partners programme, use the contact form in the Booking.com Partner Centre.    # blockAvailability See also [**blockAvailability flowchart**](https://www.lucidchart.com/publicSegments/view/936c7d7e-06e6-44b8-83e2-579074763639/image.png) **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, cancellation policy, occupancy and other things. It is possible to search for multiple properties in one request, but less detail will be given. Instead, we recommend to use **hotelAvailability** for multiple properties search.   ## blockAvailability Available Rooms ~ Best Practice This endpoint replicates Booking.com’s property brochure particularly on the available room(s) listing. **hotelAvailability** returns the cheapest room(s) combination available, whereas the **blockAvailability** gives you all available room(s) of the requested property. Just like **hotelAvailability**, **blockAvailability** also features multiple options and variants to get the available room(s) listing. You can add affiliate ID and the user platform into the request for tracking purposes. You can also filter the output. For the **blockAvailability**, we recommend the following uses: * Use this endpoint to display available room(s) listing of a single property. * Use ‘extras’ parameter with ‘extra_charges’ input value. The purpose is to show breakdown of extra charges on top of the room price that might apply. For possible extra charges, see [Possible Values page](https://developers.booking.com/api/commercial/index.html?page_url=possible-values).   ## Notes* * Although **blockAvailability** provides the converted price to another currency, we recommend to display property’s local currency. If you cannot, add a clear disclaimer on your site that explains that the property charge 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, see the [technical documentation](https://developers.booking.com/api/technical.html#!/Availability/blockAvailability).   ## blockAvailability ~ Good to Know * Your account might be restricted to one or more output fields that you see available in the [technical documentation](https://developers.booking.com/api/technical.html#!/Availability/blockAvailability). Contact your account manager. If you are part of the self-managed partners programme, use the contact form in the Booking.com Partner Centre.