Unfortunately, this feature is not supported on mobile devices. For the best experience, please use a computer.

Booking.com Demand API (3.1)

Download OpenAPI description
demand-api.json
demand-api.yaml
Languages
Servers
https://demandapi.booking.com/3.1/

Accommodations

These are the endpoints and sections specific for the stay part of the connected trip.

Use them to look for accommodation such as hotels, apartments, etc, check their availability, reviews, accommodation details, etc.

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 these identifiers to construct your requests.

Note: These identifiers are available across all travel services and you can use them for both accommodotation and car rentals 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.

curl -i -X POST \
  https://demandapi.booking.com/3.1/common/payments/cards
Experience it firsthand in the API Explorer!

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.

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 'Content-Type: application/json' \
  -d '{
    "languages": [
      "en-gb",
      "zh-cn"
    ]
  }'
Experience it firsthand in the API Explorer!

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

Cars

Operations