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.
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.
curl -i -X POST \
https://demandapi.booking.com/3.1/orders/details/cars \
-H 'Authorization: Bearer <YOUR_string_HERE>' \
-H 'Content-Type: application/json' \
-H 'X-Affiliate-Id: 0' \
-d '{
"currency": "USD",
"extras": [
"policies"
],
"orders": [
"123456789",
"098765432"
]
}'{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": [ { … } ] }
Use this endpoint to retrieve detailed information for one or more flight orders. - You can request car order details either by order ID or by reservation ID. - The response includes all relevant information for each order, such as booking and cancellation details, commission, pricing, and optional extras (for example, policies). Results are sorted by bookingDate in descending order, with the most recently booked orders listed first. It returns structured order data, including pricing, itinerary segments with IATA airport codes, etc.
This endpoint is ideal for:
- Displaying flight booking details in traveller dashboards or confirmation pages.
- Generating post-booking communications and invoices.
- Performing reporting or reconciliation tasks that require accurate itinerary and pricing data.
List of order IDs for which details should be returned. Mutually exclusive with 'reservations'.
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.
curl -i -X POST \
https://demandapi.booking.com/3.1/orders/details/flights \
-H 'Authorization: Bearer <YOUR_string_HERE>' \
-H 'Content-Type: application/json' \
-H 'X-Affiliate-Id: 0' \
-d '{
"currency": "EUR",
"orders": [
"1234567890123456",
"9876543210987654"
]
}'{ "data": [ { … } ] }
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).
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,
"change": {
"checkin": "2019-08-24",
"checkout": "2019-08-24"
},
"type": "dates"
}
}
}'{ "modification": { "accommodation": { … } } }