v3.1 Stable
The Booking.com Demand API enables Affiliate Partners to access Booking.com's travel inventory, including accommodations, car rentals, and flights.
Use Demand API to search, retrieve details, check availability, manage bookings and run reports using orders details.
Provides identifiers for a wide range of geographical locations, including airports, countries, cities, and regions.
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 modify certain aspects of an accommodation order, such as credit card details, checkin/checkout dates, and room configurations (guest allocation, guest names, and smoking preferences). See the Orders modification guide for examples and best practices.
curl -i -X POST \
https://demandapi.booking.com/3.1/orders/modify \
-H 'Authorization: Bearer <YOUR_string_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"order": "string",
"modification": {
"accommodation": {
"reservation": 0,
"type": "dates",
"change": {
"checkin": "2019-08-24",
"checkout": "2019-08-24"
}
}
}
}'{ "modification": { "accommodation": { … } } }
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 '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" } }