Try our Demand API
As a Booking.com Managed Affiliate Partner, you can explore our API collections and test them directly in this developer portal.
Before you start
Before testing the API, make sure you’ve completed the Prerequisites checklist.
This ensures you have:
- Registered as a Booking.com Managed Affiliate Partner.
- Access to Partner Centre.
- Generated a valid API key and your
X-Affiliate-Id. - Opened this Developer Portal to use the Try-out console.
Once done, continue to follow the interactive examples below.
Try-out console
You can test any Demand API collection without writing code by using this portal’s Try-out console with the provided examples.
You just need to:
- Open the API reference section.
- Select from the left-side index the endpoint you want to try.
- Add your credentials to the console (see the Authentication page for more details)
- Switch to sandbox environment to simulate real requests without creating actual bookings or charges.
- Follow the relevant quick guide (or tutorial).
All the requests must be authenticated in the console, otherwise it returns HTTP 401 error.
Give it a try
Give it a try with these two "Hello world" scenarios for the Accommodation and Car rental API collections.
Hello world - Accommodation APIs
Scenario: Search for a 2-night stay in Amsterdam for 2 adults and check the best-priced option.
1. Search for properties:
{
"city": -2140479,
"booker": { "country": "nl", "platform": "mobile" },
"checkin": "2025-11-06",
"checkout": "2025-11-08",
"guests": { "number_of_rooms": 1, "number_of_adults": 2 }
}
2. Get availability:
Include the returned accommodation id in the request (for this example we used one of the sandbox hotels: 10507360):
{
"accommodation": 10507360,
"booker": { "country": "nl", "platform": "mobile" },
"checkin": "2025-11-06",
"checkout": "2025-11-08",
"guests": { "number_of_rooms": 1, "number_of_adults": 2 }
}3. Check the recommendation
Hello world - Car rental APIs
Scenario: Search for a 2-day rental at Amsterdam Airport (AMS) and check car details.
1. Search for car rentals:
{
"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"
}
}
}
}
2. Get car details:
{
"last_modified": "2025-08-07T11:05:00+00:00",
"maximum_results": 100
}'3. Check car supplier:
Include the returned supplier id in the request:
{
"suppliers": [
516
]
}Next steps - Quick guides
Go deeper with our quick guides.
Choose the quick guide you are interested in for a step-by-step integration flow:
Accommodation - Quick guide
Follow this quick guide to try our /accommodation API collection.
Read now
Cars - Quick guide
Follow this quick guide to start playing around with our /cars API collection.
Read now
API references
Discover the API specifications and use the try out console to test the endpoints.
Check now