Our Demand API offers a wide range of functionalities for affiliate partners to be able to retrieve data 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.
curl -i -X POST \ https://demandapi.booking.com/3.1/orders/cancel \ -H 'Authorization: Bearer <YOUR_string_HERE>' \ -H 'Content-Type: application/json' \ -H 'X-Affiliate-Id: 0' \ -d '{ "order": "509430129718799", "reason": "I would like to book another property instead of this one." }'
{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": { "status": "successful" } }
Additional information related to the accommodation order.
The booker's information.
The booker's address to be used for creating this order.
An IETF language tag code that uniquely identifies a supported human language or dialect as described here: https://en.wikipedia.org/wiki/IETF_language_tag. Note that in v3 the whole tag is always lowercase. Examples: "nl" for Dutch/Nederlands or "en-us" for English (US). The full list can be obtained by calling common/languages.
"en-us"
The name of the booker.
Payment related information for the order.
All information related to airplus payment. This is required if airplus is selected as payment method.
All business related information for billing and authorisation form. This must be included for the payments that require authorisation form.
This is used to determine whether to include payment receipt_url in the response or not.
curl -i -X POST \ https://demandapi.booking.com/3.1/orders/create \ -H 'Authorization: Bearer <YOUR_string_HERE>' \ -H 'Content-Type: application/json' \ -H 'X-Affiliate-Id: 0' \ -d '{ "accommodation": { "label": "Sample label", "products": [ { "id": "333", "bed_configuration": "123456", "guests": [ { "email": "test.name@booking.com", "name": "Test Name" } ] } ], "remarks": { "estimated_arrival_time": { "hour": 12 }, "special_requests": "We will need an extra cot." } }, "booker": { "address": { "address_line": "Road-1, house-2", "city": "Amsterdam", "country": "nl", "post_code": "11111" }, "company": "Booking B.V", "email": "test.name@booking.com", "language": "en-gb", "name": { "first_name": "Test", "last_name": "Name" }, "telephone": "12345678" }, "order_token": "sample-token", "payment": { "card": { "cardholder": "Test Name", "cvc": "111", "expiry_date": "2030-10", "number": "23333333333333" }, "include_receipt": true, "method": "card", "timing": "pay_at_the_property" } }'
{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": { "accommodation": { … }, "payment": { … } } }
Filtering orders by time range on basis of order "created" or "updated" time. Maximum time range is 7 days (1 week).
ISO 8601 timestamp in UTC, which indicates the timestamp from which you want to filter orders from (inclusive). The value should be within last 1 year.
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. This input determines the currency used in the "booker_currency" fields in the output.
"EUR"
The maximum number of results to return.
curl -i -X POST \ https://demandapi.booking.com/3.1/orders/details \ -H 'Authorization: Bearer <YOUR_string_HERE>' \ -H 'Content-Type: application/json' \ -H 'X-Affiliate-Id: 0' \ -d '{ "created": { "from": "2023-02-28T02:00:00+00:00", "to": "2023-02-28T02:00:00+00:00" }, "currency": "EUR", "maximum_results": 20, "sort": { "by": "updated", "direction": "descending" }, "extras": [ "payment" ] }'
{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": [ { … } ], "metadata": { "next_page": null, "total_results": 1 } }
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.
"EUR"
curl -i -X POST \ https://demandapi.booking.com/3.1/orders/details/accommodations \ -H 'Authorization: Bearer <YOUR_string_HERE>' \ -H 'Content-Type: application/json' \ -d '{ "currency": "USD", "extras": [ "accommodation_details", "policies", "extra_charges" ], "reservations": [ 2321873123, 4666773123 ] }'
{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": [ { … } ] }
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.
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.
"EUR"
Input parameter with the checkin and checkout date and all the accommodation products to be ordered.
A signed integer number that uniquely identifies an accommodation property. The full list can be obtained by calling accommodations/details.
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.
curl -i -X POST \ https://demandapi.booking.com/3.1/orders/preview \ -H 'Authorization: Bearer <YOUR_string_HERE>' \ -H 'Content-Type: application/json' \ -H 'X-Affiliate-Id: 0' \ -d '{ "booker": { "country": "nl", "platform": "mobile", "travel_purpose": "leisure", "user_groups": [ "authenticated" ] }, "currency": "EUR", "accommodation": { "id": 6745031, "checkin": "!START_DATE!", "checkout": "!END_DATE!", "products": [ { "id": "674503106_275710478_0_2_0", "allocation": { "number_of_adults": 1, "children": [ 8 ] } }, { "id": "674503113_275710486_0_1_0", "allocation": { "number_of_adults": 1, "children": [] } } ] } }'
{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": { "accommodation": { … }, "order_token": "..." } }