Booking.com Demand API (3.1)

Our Demand API offers a wide range of functionalities for affiliate partners to be able to retrieve data from Booking.com inventory.

- Based on basic REST principles, our endpoints return JSON data directly from our system.
- You can consume them directly through HTTPS calls, using the POST method.

Download OpenAPI description

demand-api.json

demand-api.yaml

Servers

Production environment

https://demandapi.booking.com/3.1/

Sandbox environment

https://demandapi-sandbox.booking.com/3.1/

accommodations

Endpoints and sections specific to the accommodations travel vertical: hotels, apartments, etc.

Operations

cars

Endpoints and sections specific to car rentals.

Operations

common/locations

These are the endpoints you can use to retrieve the identifiers of a wide range of geographical locations: airports, countries, cities, regions, etc. Use them to construct your requests.

Operations

common/payments

Generic endpoints related to payments and finance: currencies, payment types, etc.

Operations

List payment cards

Request

This endpoint returns a list of supported payment cards and their names in English. Examples of payment types are the different credit and debit cards. To get the full list call the endpoint passing an empty body. The codes returned are what is used as input and output for other endpoints.

Headers

X-Affiliate-Idintegerrequired

Affiliate identifier

curl -i -X POST \
  https://demandapi.booking.com/3.1/common/payments/cards \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'X-Affiliate-Id: 0'

Responses

Successful response.

Bodyapplication/json

request_idstring

Uniquely identifies the request. Please provide this identifier when contacting support.

dataArray of objects(PaymentCardOutput)

Response

application/json

{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": [
    { … },
    "..."
  ]
}

List currencies

Request

This endpoint returns a list of currency codes and their names in the selected languages. To get the full list call the endpoint passing an empty body. The currency codes returned are what is used as input and output for other endpoints.

Headers

X-Affiliate-Idintegerrequired

Affiliate identifier

Bodyapplication/json

languagesArray of strings

Default ["en-gb"]

Example: ["en-us"]

curl -i -X POST \
  https://demandapi.booking.com/3.1/common/payments/currencies \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "languages": [
      "en-gb",
      "zh-cn"
    ]
  }'

Responses

Successful response.

Bodyapplication/json

request_idstring

Uniquely identifies the request. Please provide this identifier when contacting support.

dataArray of objects(CurrencyOutput)

Response

application/json

{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": [
    { … },
    "..."
  ]
}

common

Operations

orders

Operations