The Demand API allows Affiliate Partners to access Booking.com’s inventory, including accommodation, car rental, and flight information.
- The API follows REST principles and returns JSON responses.
- You can consume them directly through HTTPS calls, using the POST method.
- Note: Authentication is required using your Affiliate ID and token credentials.
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 Q3 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.
Defines the booker context.
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.
Defines the driver context.
Defines the filtering criteria for refining the request results. It allows you to specify various parameters to narrow down the available car rental options based on specific attributes.
The maximum number of results to return per page.
Effects on the selected language of the target website after redirection by provided url.
Payment-related input filters that allow you to narrow down car search results based on the payment timing options.
Defines the route context.
Drop off location and time.
Pick up / drop off datetime.
Pick up / drop off location.
Pick up / drop off location.
A three-letter code that uniquely identifies an airport as defined by the International Air Transport Association (IATA). The full list can be obtained by calling common/locations/airports.
Pick up location and time.
Pick up / drop off datetime.
Pick up / drop off location.
Pick up / drop off location.
A three-letter code that uniquely identifies an airport as defined by the International Air Transport Association (IATA). The full list can be obtained by calling common/locations/airports.
curl -i -X POST \
https://demandapi.booking.com/3.1/cars/search \
-H 'Authorization: Bearer <YOUR_string_HERE>' \
-H 'Content-Type: application/json' \
-H 'X-Affiliate-Id: 0' \
-d '{
"booker": {
"country": "nl"
},
"currency": "EUR",
"driver": {
"age": 36
},
"route": {
"dropoff": {
"datetime": "2025-11-10T11:05:00",
"location": {
"airport": "AMS"
}
},
"pickup": {
"datetime": "2025-11-05T11:05:00",
"location": {
"airport": "AMS"
}
}
}
}'{ "request_id": "01h00fr9y7qkbxtc6kyv97j49z", "data": [ { … } ], "metadata": { "next_page": "eyJhbGciOiJIUzI1NiJ9.eyJwIjp7Im1heGltdW1fcmVzdWx0cyI6MTAsIm9mZnNldCI6MTB9LCJhdWQiOiJDQVJTX1NVUFBMSUVSUyIsImV4cCI6MTY4MzY0NzMwNX0.y7NmH48mm7lImd2WxsHdotj6n-dVQAzJCGCnIJCKy3A", "total_results": 122 }, "search_token": "eyJhbGciOiJIUzI1NiJ9.eyJwIjp7ImJvb2tlciI6eyJjb3VudHJ5IjoidXMifX0sImF1ZCI6Ii9ob3RlbHMvc2VhcmNoIiwiZXhwIjoxNzUwMDAwMDAwfQ.XYZ123AbcDefGHIjklMNOpqrsTUVwxYZ456789" }
The last modified date-time, only returns depots newer than this timestamp.
The maximum number of results to return.
curl -i -X POST \
https://demandapi.booking.com/3.1/cars/depots \
-H 'Authorization: Bearer <YOUR_string_HERE>' \
-H 'Content-Type: application/json' \
-H 'X-Affiliate-Id: 0' \
-d '{
"last_modified": "2025-11-01T11:05:00+00:00",
"maximum_results": 100,
"languages": [
"en-gb",
"nl"
]
}'{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": [ { … } ], "metadata": { "next_page": null } }
Use this endpoint to return the score breakdown for the specified depots together with the overall number of reviews and score.
- Please note that the ratings score is based on all traveller traffic across Booking.com/cars, and may not necessarily reflect the experience of your own customers.
- If you choose to display or use these ratings, you are responsible for ensuring that your travellers are properly informed about what these scores represent.
The maximum number of results to return.
curl -i -X POST \
https://demandapi.booking.com/3.1/cars/depots/reviews/scores \
-H 'Authorization: Bearer <YOUR_string_HERE>' \
-H 'Content-Type: application/json' \
-H 'X-Affiliate-Id: 0' \
-d '{
"maximum_results": 10
}'{ "request_id": "01fr9ez700exycb98w90w5r9sh", "data": [ { … } ], "metadata": { "next_page": null } }
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.
This API collection is specific to Messaging integrations, 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 post-booking functionalities are available exclusively for testing purposes.
- General availability is targeted for Q3 2025.
Limited access:
- This API collection is currently accessible only to a select group of 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.