Retrieve terms and conditions

Booking.com Demand API (3.2 Beta)

3.2 Beta

These endpoints are only available in Beta.

Limited access: This API is currently offered to a limited number of pilot affiliate partners. For inquiries regarding participation, please contact our partnerships team.
Active development: These are under active development and subject to change.
Frequent updates: These API specifications will be regularly updated throughout the pilot. We recommend checking the changelog page periodically for the latest changes.

Note: Authentication is required using your Affiliate ID and token credentials.

Download OpenAPI description

demand-api.json

demand-api.yaml

Servers

Production environment

https://demandapi.booking.com/3.2/Beta/

Sandbox environment

https://demandapi-sandbox.booking.com/3.2/Beta/

Car rentals

3.2 Beta

Find here only the new car rental endpoints, which are part of the 3.2 Beta version and still under active development.

Use these endpoints to test the complete Search, look, and book flow for car rentals, including checking availability, retrieving terms and conditions, and creating an order.
See Demand API version 3.2 for other car rental endpoints.

Important:

These endpoints are currently available only in the 3.2 Beta version, are under active development and may change in future releases.
Access is limited to partners participating in the pilot/early access programme. Contact your Booking.com Account manager to request more information.

Operations

Car availability

Request

| 3.2 Beta | New |

Use this new endpoint to retrieve real-time availability details for a specific car rental offer.

The response includes information about pricing, payment options, policies (such as cancellation, mileage, and fuel), and available extras.
To call this endpoint, provide the offer ID and the search_token from your previous car search response, along with the desired currency.

Headers

X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/json

offernumber(long)required

The ID of the car offer.

search_tokenstringrequired

Encoded string returned by the car search. Note: It is specific to Car rentals and differs from other tokens used in booking flows.

currencystring^[A-Z]{3}$required

A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling common/payments/currencies.

Example: "EUR"

curl -i -X POST \
  https://demandapi.booking.com/3.2/Beta/cars/availability \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "offer": 740171366,
    "search_token": "eyJhbGciOiJIUzI1NiJ9.eyJwIjp7InNlYXJjaF9rZXkiOiJleUprY21sMlpYSnpRV2RsSWpvek5pd2laSEp2Y0U5bVprUmhkR1ZVYVcxbElqb2lNakF5TlMwd09TMHlNRlF4TVRvd05Ub3dNQ0lzSW1SeWIzQlBabVpNYjJOaGRHbHZiaUk2SWsxQlRpSXNJbVJ5YjNCUFptWk1iMk5oZEdsdmJsUjVjR1VpT2lKSlFWUkJJaXdpY0dsamExVndSR0YwWlZScGJXVWlPaUl5TURJMUxUQTVMVEU0VkRFeE9qQTFPakF3SWl3aWNHbGphMVZ3VEc5allYUnBiMjRpT2lKTlFVNGlMQ0p3YVdOclZYQk1iMk5oZEdsdmJsUjVjR1VpT2lKSlFWUkJJaXdpY21WdWRHRnNSSFZ5WVhScGIyNUpia1JoZVhNaU9qSXNJbk5sY25acFkyVkdaV0YwZFhKbGN5STZXeUpUVlZCUVVrVlRVMTlFU1ZKRlExUmZVRUZaWDB4UFEwRk1YMVpGU0VsRFRFVlRJbDE5IiwiYm9va2VyIjp7ImNvdW50cnkiOiJnYiJ9fSwiYXVkIjoiL2NhcnMvYXZhaWxhYmlsaXR5IiwiZXhwIjoxNzUzMTA2MDg2fQ.t8VrrJhUAvbAwIK_bO5cNAIB5Z_UfcolMEsGzlq3-eo",
    "currency": "GBP"
  }'

Responses

Successful response.

Bodyapplication/json

request_idstring

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

dataobject

Response

application/json

{
  "request_id": "01k1deq3e5b41da80f28yybhz0",
  "data": {
    "offer": "740171366",
    "currency": "GBP",
    "policies": { … },
    "price": { … },
    "products": [ … ],
    "deal": null,
    "supplier": 3486,
    "depot": 38566
  }
}

Retrieve terms and conditions

Request

| 3.2 Beta | New |

Use this endpoint to retrieve the terms and conditions for a specific car rental offer during the pre-booking process.

The response includes structured, localised content in the requested language, covering key policies such as driver requirements, mileage, deposits, and damage excess.
Use this endpoint to display relevant terms to travellers before confirming a booking.

Headers

X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/jsonrequired

offernumber(long)required

Unique identifier of the rental offer selected from the /cars/search results. This ID is required to retrieve the corresponding terms and conditions for a specific vehicle, as shown to the traveller. The offer is scoped to the associated search_token, and may change between searches.

currencystringrequired

The currency in ISO 4217 format (e.g., USD, EUR, GBP)

Example: "USD"

languagestring^[a-z]{2}(-[a-z]{2})?$

The language code (ISO 639-1 format) in which to return the terms and conditions.

Example: "en-us"

search_tokenstringrequired

The pre-booking search_token used to fetch terms and conditions for a specific car rental offer. The search_token is returned by the search endpoint.

curl -i -X POST \
  https://demandapi.booking.com/3.2/Beta/cars/terms-and-conditions \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "offer": "123456789",
    "currency": "USD",
    "language": "en-us",
    "search_token": "eyJkcml2ZXJzQWdlIjozMCwiZHJvcE9mZkRhdGVUaW1lIjo"
  }'

Responses

Successful response.

Bodyapplication/json

dataobject

request_idstring

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

Response

application/json

{
  "data": {
    "key_info": { … },
    "terms": [ … ]
  }
}

Attractions

| 3.2 Beta | New |

The Attractions API collection introduces a new travel service asset within the Demand API.

Use these endpoints to search for attractions, retrieve detailed information, and store static data.

Important:

These endpoints are currently available only in the 3.2 Beta version, are under active development and may change in future releases.
Access is limited to partners participating in the pilot/early access programme. Contact your Booking.com Account manager to request more information.

Operations

Orders

| 3.2 Beta | Changed |

Find in this version only the order endpoints that provide support to the car rental booking.

Use these endpoints to preview and create new car rental orders, check car order details, cancel or modify car rental orders.
This collection is required to integrate booking and order management functionality with car rental.

Important:

These endpoints are also available in version 3.2 but without the car implementation.
Support to car rental booking is only available in the 3.2 Beta version, as are under active development and may change in future releases.
Access is limited to partners participating in the pilot/early access programme. Contact your Booking.com Account manager to request more information.

Operations

Messages

3.2 Beta

This API collection allows two-way post-booking communication between guests and properties and is currently available in the 3.2 Beta version.

Use these endpoints to test the complete communication flow, including sending and retrieving messages, conversations and attachments.

Important:

These endpoints are currently available only in the 3.2 Beta version, are under active development and may change in future releases.
Access is limited to partners participating in the pilot/early access programme. Contact your Booking.com Account manager to request more information.

Operations

Conversations

Provides endpoints to retrieve and manage messaging conversations.

Use these endpoints to list conversations, fetch conversation details, and track updates.

Operations

Attachments

Provides endpoints for handling message attachments.

Use these endpoints to upload and download images shared within conversations.

Operations