Sign in
latestOpenAPI 3.0.12026-08-101058136.3 KB

0fbdc2f4423a

demand-api-v2-compatible

List all bookable rooms at a property

This endpoint is where you find a list of all bookable or available 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. You can find detailed information about one hotel per search (detail_level) which will return most of the information needed to replicate the booking.com property page.

If you want to search multiple hotels, you can, but you get less detail. For searching multiple hotels, it is recommended to use hotelAvailability.

get/demand-api-v2-compatible/blockAvailability

Query parameters

hotel_idsinteger[] required

Hotel ID(s) to check availability for.

checkinstring date required

The arrival date.

checkoutstring date required

The departure date. Must be later than {checkin}.

guest_ccstring required

Guest country code. Used to accurately display the best prices and price details for people from that country.

currencystring

Returns the prices in this currency, in addition to the hotel currency.

extrasstring[]

The extra items for this request. See the documentation for more details about each extra.

affiliate_idstring

Application affiliate id

block_idsstring[]

Return only availability hits with these particular block IDs

guest_ipstring

Guest IP address for determining guest country and showing the best price for that user and obeying laws regarding the display of taxes and fees.

guest_qtyinteger[]

Number of guests for which blocks will be found. The total number of guests is used for calculating city tax charges. It is specified as an array of guest numbers.

If you use this parameter and make bookings through the API, you should also set the exact same value in the guest_quantities parameter for the processBooking call, otherwise per-person included charges may result in pricing problems, causing the booking to fail.

NOTE: After version 2.6 either this or room1 needs to be provided.

language'ar' | 'bg' | 'ca' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'en-gb' | 'en-us' | 'es' | 'es-ar' | 'es-mx' | 'et' | 'fi' | 'fr' | 'he' | 'hi' | 'hr' | 'hu' | 'id' | 'is' | 'it' | 'ja' | 'ka' | 'ko' | 'lt' | 'lv' | 'ms' | 'nl' | 'no' | 'pl' | 'pt-br' | 'pt-pt' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sr' | 'sv' | 'th' | 'tl' | 'tr' | 'uk' | 'vi' | 'zh' | 'zh-cn' | 'zh-tw'

Specify the language for: block_id, policies, room texts and hotel descriptions.

Note: not all text is translated in all languages. Please check the "Possible Values" section of the documentation for the accepted language codes.

num_roomsinteger

Takes a number of rooms to put guests into

room1string[]

Which guests to put in which rooms. Syntax: comma-separated list, A for each adult, a number in the range 0..17 for each child.

user_platform'ANDROID' | 'DESKTOP' | 'IOS' | 'MOBILE' | 'TABLET'

The user's platform.

{
  "block_ids": [
    "5555555_55555555_5_5_5,6666666_66666666_6_6_6"
  ]
}

Headers

Accept'application/json, application/xml'

Response

OK

Example response

{
  "result": [
    {
      "hotel_url": "https://www.booking.com/hotel/nl/toren.html"
    }
  ]
}