Use the Demand API Try-out console to explore endpoints and test requests with sandbox data.
Before testing the API, complete the Prerequisites checklist.
You need to:
- Register as a Booking.com Managed Affiliate Partner.
- Have access to Partner Centre.
- Generate a valid API key and obtain your
X-Affiliate-Id. - Open the Developer Portal and access the Try-out console.
For more information, see the Authentication guide.
You can test supported Demand API endpoints directly in the Developer Portal without writing code.
To try an endpoint:
- Open the API reference of the version you want to test.
- Select the endpoint you want to test from the navigation.
- Add your credentials to the Try-out console.
- Select the Sandbox environment.
- Submit the request and review the response.
- Follow the relevant quick guide for a Search, look and redirect integration flow.
See Authentication in the Try-out console for more information.
The sandbox lets you test requests with test data without creating real orders, bookings or charges. Sandbox data and supported scenarios may differ from the production environment.
See the Sandbox guide for more details.
The following examples show how to make basic requests to the Accommodations and Cars API collections using the latest Demand API version.
Requests sent through the Try-out console must include valid authentication. Requests with missing or invalid credentials return 401 Unauthorized.
Scenario: Search for a two-night stay in Amsterdam for two adults and review the available options.
1. Search for accommodation
{
"city": -2140479,
"booker": {
"country": "nl",
"platform": "mobile"
},
"checkin": "2026-11-06",
"checkout": "2026-11-08",
"guests": {
"number_of_rooms": 1,
"number_of_adults": 2
}
}Save the id of an accommodation from the response. You need it for the availability request.
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": "2026-11-06",
"checkout": "2026-11-08",
"guests": {
"number_of_rooms": 1,
"number_of_adults": 2
}
}3. Review the response
Review the availability response to identify the recommended or best-priced option for the requested dates and guests.
Use the Accommodation quick guide to continue with a complete Search, look and redirect flow.
Scenario: Search for a two-day car rental at Amsterdam Airport (AMS) and review the available car rental information.
1. Search for car rentals:
{
"booker": {
"country": "nl"
},
"currency": "EUR",
"driver": {
"age": 36
},
"route": {
"pickup": {
"datetime": "2026-11-05T11:05:00",
"location": {
"airport": "AMS"
}
},
"dropoff": {
"datetime": "2026-11-07T11:05:00",
"location": {
"airport": "AMS"
}
}
}
}
Save a supplier ID returned by the response if you want to use it in the next request.
2. Retrieve car details:
{
"last_modified": "2026-08-07T11:05:00+00:00",
"maximum_results": 100
}3. Check car supplier details:
Include the supplier ID returned by the previous response.
{
"suppliers": [
516
]
}Review the supplier name returned in the response.
Use the Cars quick guide to continue with a complete Search, look and redirect car rental integration flow.
Go deeper with our quick guides for a step-by-step integration flow:
