These are the endpoints and sections specific for the stay part of the connected trip.
Use them to look for accommodation such as hotels, apartments, etc, check their availability, reviews, accommodation details, etc.
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.
Use this endpoint to process an order cancellation. Refer to the Cancellations guide for instructions, tips and examples.
curl -i -X POST \ https://demandapi.booking.com/3.1/orders/cancel \ -H 'Content-Type: application/json' \ -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 'Content-Type: application/json' \ -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.
"EUR"
The maximum number of results to return.
Input parameter to request for additional information about this order.
curl -i -X POST \ https://demandapi.booking.com/3.1/orders/details \ -H 'Content-Type: application/json' \ -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 'Content-Type: application/json' \ -d '{ "currency": "USD", "extras": [ "policies", "extra_charges" ], "reservations": [ 2321873123, 4666773123 ] }'
{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": [ { … } ] }
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/cars \ -H 'Content-Type: application/json' \ -d '{ "currency": "USD", "extras": [ "policies" ], "orders": [ "123456789", 98765432 ] }'
{ "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 'Content-Type: application/json' \ -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": "..." } }
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/flights \ -H 'Content-Type: application/json' \ -d '{ "currency": "EUR", "orders": [ "ssdfugrjndknkgj" ] }'
{ "data": { "flights": [ … ] } }