Our Demand API offers a wide range of functionalities for Affiliate Partners to be able to retrieve accommodation, car rental and flights information from Booking.com inventory.
- Based on basic REST principles, our endpoints return JSON data directly from our system.
- You can consume them directly through HTTPS calls, using the POST method.
Use this endpoint to retrieve detailed product availability, price and charges of a list of accommodations. By default, only product availability and price is returned.
To receive extended information use the extras parameter.
Note: It is mandatory to pass the 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 filters to apply in this availability request.
The guest details for the request.
curl -i -X POST \
https://demandapi.booking.com/3.1/accommodations/bulk-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": [ { … } ] }
A chain-branded accommodation is one that is associated with a larger corporation group, and as such, operates under a recognized brand. The information returned can be used to filter accommodation searches based on particular chains or brands. An example of a chain is "Radisson Hotel Group". To get the full list call the endpoint passing an empty body. The codes returned are what is used as input and output for other endpoints.
curl -i -X POST \
https://demandapi.booking.com/3.1/accommodations/chains \
-H 'Authorization: Bearer <YOUR_string_HERE>' \
-H 'X-Affiliate-Id: 0'{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": [ { … }, "..." ] }
This endpoint enumerates the internal codes and names, in the selected languages, for relevant accommodation specific types. These accommodation specific types include the list of facilities that may be available at a property like "Elevator" or "Swimming pool outdoor". For example, the following parameters will return the full list in English (US) and French: {"languages":"en-us","fr"}. To get the full list call the endpoint passing an empty body. The codes returned are what is used as input and output for other endpoints in the accommodations namespace.
Allows to filter the results only for specific sections.
curl -i -X POST \
https://demandapi.booking.com/3.1/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": [ … ] } }
This API collection is specific to the car rentals part of the connected trip, and form part of an early access pilot programme restricted to selected partners.
Pilot phase:
- All the functionalities are currently under active development and are subject to change.
- Initial search, look, and post-book functionalities (Type 2 and Type 4 partners) are available exclusively for testing purposes.
- General availability is targeted for Q2 2025.
Limited access:
- This API collection is currently accessible only to a select group of Type 2 and Type 4 pilot partners.
- If you are not part of the pilot, you will not have access to these endpoints.
- For inquiries regarding participation, please contact our Partnerships team.
Frequent updates:
These endpoints and documentation will be updated regularly throughout the pilot.
These are the endpoints you can use to retrieve the identifiers of a wide range of geographical locations: airports, countries, cities, regions, etc.
Use these identifiers to construct your requests.
Note: These identifiers are available across all travel services and you can use them for both accommodotation and car rentals requests.
These endpoints enable you to manage and process booking orders within the Demand API. These operations include previewing and creating new orders, checking order details, cancelling existing orders, and modifying orders if needed.
This API collection is essential for integrating the order management functionality, such as handling bookings, cancellations, and updates to reservation details, etc.