Last updated

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 - prerequisites

Before you start testing, make sure you have:

Checklist
Registered as a Booking.com Managed Affiliate Partner.
Access to Partner Centre (provided by your Booking.com Account Manager after signing the agreed contract).

In Partner Centre, generated:

Have this Developer Portal open to access the Try-out console (see instructions 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:

  1. Open the API reference section.
  2. Select from the left-side index the endpoint you want to try.
  3. Add your credentials to the console (see the Authentication page for more details)
  4. Switch to sandbox environment to simulate real requests without creating actual bookings or charges.
  5. 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.

⏱️ Estimated time to complete: 2-3 minutes

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 }
}

Try in console

Keep the accommodation id from the first result.

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 }
}

Try in console

3. Check the recommendation

Identify the recommendation field with the best-price option for the search criteria.

Hello world - Car rental APIs

Scenario: Search for a 2-day rental at Amsterdam Airport (AMS) and check car details.

⏱️ Estimated time to complete: 2-3 minutes

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"
        }
      }
    }
  }

Try in console

2. Get car details:

{
    "last_modified": "2025-08-07T11:05:00+00:00",
    "maximum_results": 100
}'

Try in console

Keep the supplier id from the first result.

3. Check car supplier:

Include the returned supplier id in the request:

{
  "suppliers": [
    516
  ]
}

Try in console

Identify the supplier `name` field in the response.

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 API Quick guide

Follow this quick guide to try our /accommodation API collection.

Read now

Cars API Quick guide

Follow this quick guide to start playing around with our /cars API collection.

Read now

Accommodation API reference

Discover the accommodation API specifications and use the try out console to test the endpoints.

Check now

Cars API reference

Check the Cars API specifications and use the try out console to get familiar with the endpoints.

Check now