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

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:

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