GETTING STARTED
/
Try the Demand API
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 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:

  1. Open the API reference section
  2. Select the endpoint you want to try.
  3. Add your credentials (see the Authentication section for more details)
  4. Follow the relevant quick guide.

All examples on this page can be tested in sandbox mode, which simulates real requests without creating actual bookings or charges.
See Using the sandbox environment for details.

All the requests must be authenticated in the console, otherwise it returns HTTP 401 error.

🚀 Hello world - Accommodation

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

→ Run in console

Keep the accommodation `id` from the first result.
  1. Get availability

Include the returned accommodation id in the request:

{
  "accommodation": 10507360,
  "booker": { "country": "nl", "platform": "mobile" },
  "checkin": "2025-11-06",
  "checkout": "2025-11-08",
  "guests": { "number_of_rooms": 1, "number_of_adults": 2 }
}

→ Run in console

  1. Check the recommendation
  • Identify in the response the recommendation field with the best-price option for the search criteria.

🚀 Hello world - Car rental

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

→ Run in console

  1. Get car details
{
    "last_modified": "2025-08-07T11:05:00+00:00",
    "maximum_results": 100
}'

→ Run in console

Keep the supplier `id` from the first result.
  1. Check car supplier

Include the returned supplier id in the request:

{
  "suppliers": [
    516
  ]
}

→ Run in console

  • Identify in the response the supplier name field.

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

Previous page
Next page