List all bookable rooms at a property

Request

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.

Security

BearerAuth

Query

blockInputobject(BlockAvailabilityInputDto)required

Acceptstring

Value:"application/json, application/xml"

GET

/demand-api-v2-compatible/blockAvailability

import requests

url = "https://metasearch-connect-api.booking.com/demand-api-v2-compatible/blockAvailability"

query = {
  "blockInput": "hotel_ids=0&checkin=2019-08-24&checkout=2019-08-24&guest_cc=string&currency=string&extras=ADDON_TYPE&affiliate_id=string&block_ids=5555555_55555555_5_5_5,6666666_66666666_6_6_6&guest_ip=string&guest_qty=0&language=ar&num_rooms=0&room1=string&user_platform=ANDROID"
}

headers = {
  "Accept": "application/json, application/xml",
  "Authorization": "Bearer <YOUR_string_HERE>"
}

response = requests.get(url, headers=headers, params=query)

data = response.json()
print(data)

Responses

OK

Body

metaobject(Meta)

resultArray of objects(BlockAvailabilityOutputDto)

Response

{
  "meta": {
    "ruid": "string"
  },
  "result": [
    { … }
  ]
}