Demand API version 3.2 introduces several improvements and breaking changes from version 3.1, including updates to accommodation booking flows, inclusion of Attractions in orders/details for post-booking reporting and other structural enhancements.
- The API follows REST principles and returns data in JSON format.
- You can access endpoints via HTTPS POST requests.
Authentication: Use your Affiliate ID and token credentials to use these endpoints.
Try it out!
Use this endpoint to check real-time availability, prices, and charges for one or more accommodations. By default, only product availability and price is returned.
To retrieve extended details such as extra charges or payment information, use the extras or filters parameters.
You must provide the following required input parameters: accommodations, booker, checkin, checkout, and guests.
The booker's information.
The booker country for showing the best price for that user and obeying laws regarding the display of taxes and fees.
The booker platform for showing the platform based deals and prices.
The booker state for showing the best price for that user and obeying laws regarding the display of taxes and fees. Currently applicable only for country US.
The checkin date. Must be within 500 days in the future and in the format yyyy-mm-dd.
The checkout date. Must be later than {checkin}. Must be between 1 and 90 days after {checkin}. Must be within 500 days in the future and in the format yyyy-mm-dd.
A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling common/payments/currencies.
Input parameter to request for additional information about this product.
The guest details for the request.
curl -i -X POST \
https://demandapi.booking.com/3.2/accommodations/availability \
-H 'Authorization: Bearer <YOUR_string_HERE>' \
-H 'Content-Type: application/json' \
-H 'X-Affiliate-Id: 0' \
-d '{
"accommodations": [
10004
],
"booker": {
"country": "nl",
"platform": "desktop"
},
"checkin": "!START_DATE!",
"checkout": "!END_DATE!",
"extras": [
"extra_charges"
],
"filters": {
"meal_plan": "breakfast_included",
"cancellation_type": "free_cancellation"
},
"guests": {
"number_of_adults": 2,
"number_of_rooms": 1
}
}'{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": [ { … } ] }
Use this endpoint to retrieve a list of accommodation chains and their associated brands.
A chain-branded accommodation is part of a larger corporate group and operates under a recognised brand. The returned information can be used to filter search results by chain or brand across other endpoints.
- To obtain the full list of chains, call this endpoint with an empty request body.
- The id values returned are the codes used as input and output in other API requests, ensuring consistency across your integration.
Example of chain - "Radisson Hotel Group" with brands such as "Radisson Blu" or "Park Inn by Radisson."
curl -i -X POST \
https://demandapi.booking.com/3.2/accommodations/chains \
-H 'Authorization: Bearer <YOUR_string_HERE>' \
-H 'X-Affiliate-Id: 0'{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": [ { … }, "..." ] }
Use this endpoint to retrieve standardised codes and names for accommodation-specific types, including facilities, room types, bed types, themes, and charges.
These constants can be used to filter searches or populate reference data across other accommodation endpoints.
You can request multiple languages using IETF language tags (see common/languages).
Call with an empty body to retrieve all constants. The codes returned are canonical identifiers used across the API.
Allows to filter the results only for specific sections.
curl -i -X POST \
https://demandapi.booking.com/3.2/accommodations/constants \
-H 'Authorization: Bearer <YOUR_string_HERE>' \
-H 'Content-Type: application/json' \
-H 'X-Affiliate-Id: 0' \
-d '{
"languages": [
"en-gb",
"zh-cn"
]
}'{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": { "accommodation_facilities": [ … ], "accommodation_themes": [ … ], "accommodation_types": [ … ], "bed_types": [ … ], "charge_types": [ … ], "facility_types": [ … ], "review_scores": [ … ], "room_facilities": [ … ], "room_types": [ … ] } }
Provides generic payment-related identifiers, including supported currency codes, payment cards, and relevant metadata for booking flows.
- Use the returned identifiers when constructing requests across all travel services API collections, including both accommodation and car rental endpoints.