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

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
Languages
Servers
Mock server
https://developers.booking.com/_mock/demand/docs/open-api/demand-api/
https://demandapi-sandbox.booking.com/3.1/
https://demandapi.booking.com/3.1/

accommodations

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

Operations

common/locations

Generic endpoints related with geographical locations: countries, cities, etc.

Operations

common/payments

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

Operations

common

Operations

List languages

Request

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

Headers
X-Affiliate-Idintegerrequired

Affiliate identifier

curl -i -X POST \
  https://developers.booking.com/_mock/demand/docs/open-api/demand-api/common/languages \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'X-Affiliate-Id: 0'
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
Response
application/json
{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": [
    { … },
    "..."
  ]
}

orders

Operations