# Booking.com Demand API

The Booking.com Demand API enables Affiliate Partners to access Booking.com's travel inventory, including accommodations, car rentals, and flights. The version 3.2 introduces several improvements and breaking changes from version 3.1, including updates to **price structures**, inclusion of **Attractions and taxis in orders/details** for post-booking reporting, and other structural enhancements.

- The API follows REST principles and returns data in **JSON** format.
- You can access endpoints via **HTTPS POST** requests.

Authentication: Use your Affiliate ID and token credentials to use these endpoints.

[Check the Try out guide!](/demand/docs/getting-started/try-out-the-api)

Version: 3.2

## 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/demand-api.yaml)

## Accommodation

 - [POST /accommodations/search](https://developers.booking.com/demand/docs/open-api/3.2/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/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/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/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/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/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/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/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/third-party-suppliers](https://developers.booking.com/demand/docs/open-api/3.2/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
## Car rentals

 - [POST /cars/search](https://developers.booking.com/demand/docs/open-api/3.2/demand-api/cars/search.md): Use this endpoint to retrieve the available car rentals matching the search criteria.
 - [POST /cars/constants](https://developers.booking.com/demand/docs/open-api/3.2/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/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/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/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/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
## Locations

 - [POST /common/locations/airports](https://developers.booking.com/demand/docs/open-api/3.2/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/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/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/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/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/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/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/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/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/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/demand-api/orders/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/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/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/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/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/modify](https://developers.booking.com/demand/docs/open-api/3.2/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/cancel](https://developers.booking.com/demand/docs/open-api/3.2/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