# Booking.com Demand API

**Beta version – experimental endpoints**

This API version is **currently in Beta** and is offered to a limited set of pilot affiliate partners. Access is granted on request via your Booking.com account manager.

> ⚠️ **Important:** This API is **under active development**. Endpoints, request/response structures, and functionality may change without prior notice. Specifications are updated frequently during the pilot phase.

- Consult the [Changelog](/demand/docs/whats-new/changelog) for the latest updates.
- All requests **require authentication** using your Affiliate ID and token credentials.

Version: 3.2-Beta

## Servers

[object Object]
```
https://demandapi.booking.com/3.2
```

[object Object]
```
https://demandapi-sandbox.booking.com/3.2
```

## Security

### BearerAuth

Type: http
Scheme: bearer
Bearer Format: string

## Download OpenAPI description

 - [Booking.com Demand API](https://developers.booking.com/_bundle/demand/docs/open-api/3.2-beta/demand-api.yaml)

## Accommodation

 - [POST /accommodations/search](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/search.md): Use this endpoint to search for accommodations that match your specified criteria. <br/>By default, **the response returns the cheapest available product** for each accommodation.<br/><br/>When applyi
 - [POST /accommodations/availability](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/availability.md): Use this endpoint to check real-time availability, prices, and charges for **up to 50 accommodation IDs**. - By default, only product availability and prices are returned. - Use the `extras` or `filte
 - [POST /accommodations/chains](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/chains.md): Use this endpoint to retrieve a list of accommodation chains and their associated brands. A chain-branded accommodation is part of a larger corporate group and operates under a recognised brand. The r
 - [POST /accommodations/constants](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/constants.md): Retrieve standardised codes and names for accommodation-related entities, such as facilities, room types, bed types, themes, and additional charges. These constants are canonical identifiers that can
 - [POST /accommodations/details](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/details.md): Retrieve detailed information about accommodation properties that match your search criteria. You must provide at least one of the following parameters: `accommodations`, `airport`, `city`, `country`,
 - [POST /accommodations/details/changes](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/details/changes.md): Use this endpoint to track accommodations that have opened, closed, or had content updates since a specific timestamp. Changes can include updates to general information, facilities, rooms, photos, pa
 - [POST /accommodations/reviews](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/reviews.md): This endpoint provides access to reviews for specified accommodations, allowing you to retrieve traveller feedback associated with a particular property.</br></br> The reviews returned can be [filtere
 - [POST /accommodations/reviews/scores](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/reviews/scores.md): This endpoint returns score distribution and score breakdown for the specified accommodations. The scores information can be filtered by reviewer parameters and languages.
 - [POST /accommodations/smart-search](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/smart-search.md): Use this endpoint to search for accommodations using a natural language query combined with structured travel criteria such as dates, guests, location, and sorting preferences. The `search_query` fiel
 - [POST /accommodations/third-party-suppliers](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/third-party-suppliers.md): Use this endpoint to retrieve the list of third-party suppliers that facilitate accommodation inventory on Booking.com. A third-party supplier is an external partner company that provides accommodatio
## Attractions

 - [POST /attractions/search](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/attractions/search.md): Use this endpoint to search for attractions based on a single search criterion, such as attraction IDs, cities, countries, or geographic coordinates.
 - [POST /attractions/details](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/attractions/attractions/details.md): Use this endpoint to retrieve static information about attractions such as name, description, address, URL, etc. **Note:** This endpoint does not return any pricing information.
 - [POST /attractions/reviews](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/attractions/attractions/reviews.md): Retrieves reviews for a specific attraction. The reviews returned can be filtered and sorted, with the option to limit the number of reviews per attraction by specifying the "rows" parameter. **Note:*
 - [POST /attractions/reviews/scores](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/attractions/attractions/reviews/scores.md): Returns detailed review scores for specific attractions.
 - [POST /attractions/constants](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/attractions/constants.md): Returns localised attraction constants, including category and subcategory metadata. - Use this endpoint to retrieve and cache the category ID-to-name mapping before performing attraction searches wi
## Car rentals

 - [POST /cars/search](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/cars/search.md): Use this endpoint to retrieve the available car rentals matching the search criteria.
 - [POST /cars/availability](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/cars/availability.md): Retrieve availability details for a specific car rental offer, including final pricing, available insurance options, and optional extras (such as an additional driver or child seat) that can be added
 - [POST /cars/constants](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/cars/constants.md): This endpoint returns localised car rental constants used across the Cars API collection, such as extras, fuel policies, payment timings, and transmission types. It also returns customer service cont
 - [POST /cars/depots](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/cars/depots.md): Retrieve a paginated list of car rental depots. Supports incremental updates via the `last_modified` filter.
 - [POST /cars/depots/reviews/scores](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/cars/depotscores.md): Use this endpoint to retrieve review scores and score breakdowns for depots, including the overall review score and total number of reviews.
 - [POST /cars/details](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/cars/details.md): Use this endpoint to fetch car details like bag capacity, number of doors, brand and model, etc.
 - [POST /cars/suppliers](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/cars/suppliers.md): Use this endpoint to fetch a list of car rental suppliers. <br/>You can use a supplier ID (or an array of them), to retrieve specific details. <br/>Alternatively, if you do not add any ID in the reque
 - [POST /cars/terms-and-conditions](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/cars/terms-and-conditions.md): Use this endpoint to retrieve the terms and conditions for a specific car during the pre-booking process. The response includes structured content in the requested language.
## Autocomplete

 - [POST /common/autocomplete](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/commonautocomplete/common/autocomplete.md): Returns ranked suggestions based on the free-text query, destination popularity, and the provided context. This endpoint is designed for real-time "as-you-type" autocomplete experiences.\n\nSupports p
## Locations

 - [POST /common/locations/airports](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/commonlocations/common/locations/airports.md): This endpoint returns a list of airport codes and their names in the selected languages. The airports returned may be filtered by a location id. For example, you can get the list of airports in The Ne
 - [POST /common/locations/cities](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/commonlocations/common/locations/cities.md): This endpoint returns a list of city IDs and their names in the selected languages. You can filter the results by location ID. For example, to retrieve the list of cities in the Netherlands, pass: `{"
 - [POST /common/locations/countries](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/commonlocations/common/locations/countries.md): This endpoint returns a list of country codes and their names in the selected languages. The countries returned may be filtered by a location id. For example, you can get the list of countries that ar
 - [POST /common/locations/districts](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/commonlocations/common/locations/districts.md): This endpoint returns a list of districts with translations in the selected languages. The districts returned may be filtered by a location id. For example, you can get the list of districts in Amster
 - [POST /common/locations/landmarks](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/commonlocations/common/locations/landmarks.md): This endpoint returns a list of relevant geographical landmark codes and their names in the selected languages. The landmarks returned may be filtered by a location id. For example, you can get the li
 - [POST /common/locations/regions](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/commonlocations/common/locations/regions.md): This endpoint returns a list of regions with translations in the selected languages. The regions returned may be filtered by a location id. For example, you can get the list of regions in the Netherla
## Payments

 - [POST /common/payments/cards](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/commonpayments/common/payments/cards.md): 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. <br/><br/>To get the full list call the endpoint
 - [POST /common/payments/currencies](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/commonpayments/common/payments/currencies.md): 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. <br/><br/>The currency codes returned are what i
## Languages

 - [POST /common/languages](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/commonlanguages/common/languages.md): 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 i
## Orders

 - [POST /orders/preview](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/orders/orders/preview.md): Use this endpoint to validate an order before checkout and calculate the final price, including a detailed price breakdown, payment schedule, and cancellation policies for accommodation and car rental
 - [POST /orders/create](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/orders/create.md): Use this endpoint to create and confirm an order using a valid order token and the required payment information.
 - [POST /orders/details](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/orders/orders/details.md): Use this endpoint to retrieve detailed information about existing orders across supported travel services. Use it to synchronise internal systems, monitor booking updates, and generate reporting or an
 - [POST /orders/details/accommodations](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/orders/orders/details/accommodations.md): Use this endpoint to retrieve detailed information for one or more accommodation orders.You can request order details either by **reservation** or **order** ID depending on your integration. - The res
 - [POST /orders/details/cars](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/orders/orders/details/cars.md): Use this endpoint to retrieve detailed information for one or more car rental orders. - You can request car order details using your **reservation** ID. - The response includes booking and cancellatio
 - [POST /orders/details/flights](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/orders/orders/details/flights.md): Use this endpoint to retrieve detailed information for one or more flight orders. - You can request flight order details either by **order ID** or by **reservation ID**. - The response includes struct
 - [POST /orders/details/cars/terms-and-conditions](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/orders/cars-terms-and-conditions.md): Retrieve the full, structured terms and conditions for one or more car rental orders. The response contains **hierarchical legal content** organised into chapters containing nested sections, clauses,
 - [POST /orders/details/cars/faq](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/orders/cars/faqs.md): Returns a list of frequently asked questions (FAQs) and their answers related to car rentals. You can request one or more preferred languages using the languages parameter. If content is not available
 - [POST /orders/details/cars/live](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/orders/details/cars/live.md): Returns enriched, live car order details for a specific reservation, including vehicle, supplier, pricing, insurance, policy, and driver information. This endpoint is currently available as a beta fe
 - [POST /orders/modify](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/orders/orders/modify.md): Use this endpoint to modify certain aspects of an accommodation order, such as credit card details, checkin/checkout dates, and room configurations (guest allocation, guest names, and smoking preferen
 - [POST /orders/modify/preview](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/orders/orders/modify/preview.md): Preview whether a requested modification can be applied to an order and retrieve the expected cost impact before confirming the change. Use this endpoint to: - Check if the requested modification ca
 - [POST /orders/cancel](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/orders/orders/cancel.md): Use this endpoint to cancel a travel service within an existing order. Provide the details of the reservation or insurance policy you want to cancel. - **Note:** Only one travel service can be cancell
## Messages

 - [POST /messages/send](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/messages/send.md): Use this endpoint to send a message to a conversation. You can include plain text and optionally attach a file using an attachment ID from a previous upload.
 - [POST /messages/latest](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/messages/latest.md): Use this endpoint to **fetch the most recent messages**, including messages sent by both the property and the guest. By default, up to **100 messages** are returned in reverse chronological order (new
 - [POST /messages/latest/confirm](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/messages/confirm.md): Use this endpoint to confirm receipt of messages. Confirmation is required in order to receive new messages from POST /messages/latest.
 - [POST /messages/attachments/metadata](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/messages/metadata.md): Use this endpoint to get basic information about an uploaded file, such as its name, type, and size.
## Conversations

 - [POST /messages/conversations](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/conversations/conversations.md): Use this endpoint to retrieve a conversation available to the authenticated user.
## Attachments

 - [POST /messages/attachments/upload](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/attachments/upload.md): Use this endpoint to upload a file to be used as a message attachment. The response includes an attachment ID to reference when sending messages.
 - [POST /messages/attachments/download](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/attachments/download.md): Use this endpoint to retrieve a file that was attached to a message. The response includes the file in a base64-encoded format.