# 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. Use Demand API to search, retrieve details, check availability, manage bookings and run reports using orders details. - RESTful API with JSON responses. - Make HTTPS POST requests to interact with endpoints. - Requires authentication using your Affiliate ID and token credentials. [Check the try out guide!](/demand/docs/getting-started/try-out-the-api) Version: 3.1 ## Servers Production environment ``` https://demandapi.booking.com/3.1 ``` Sandbox environment ``` https://demandapi-sandbox.booking.com/3.1 ``` ## 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/demand-api.yaml) ## Accommodation - [POST /accommodations/search](https://developers.booking.com/demand/docs/open-api/demand-api/accommodations/accommodations/search.md): This endpoint returns, by default, the cheapest available product for each accommodation that matches the specified search criteria.

When you apply location filters using parameters such as - [POST /accommodations/availability](https://developers.booking.com/demand/docs/open-api/demand-api/accommodations/accommodations/availability.md): Use this endpoint to return detailed product availability, price and charges of the accommodation matching a given search criteria.
By default, only product availability and price is returned. To - [POST /accommodations/bulk-availability](https://developers.booking.com/demand/docs/open-api/demand-api/accommodations/accommodations/bulk-availability.md): Use this endpoint to retrieve detailed product availability, price and charges of a list of accommodations. By default, only product availability and price is returned.
To receive extended inform - [POST /accommodations/chains](https://developers.booking.com/demand/docs/open-api/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 br - [POST /accommodations/constants](https://developers.booking.com/demand/docs/open-api/demand-api/accommodations/accommodations/constants.md): Use this endpoint to retrieve standardised codes and names for accommodation-specific types, including facilities, room types, bed types, themes, and charges.
These constants can be used to filte - [POST /accommodations/details](https://developers.booking.com/demand/docs/open-api/demand-api/accommodations/accommodations/details.md): This endpoint returns detailed information on all accommodation properties matching a given search criteria. By default, only basic information is returned.

It is mandatory to pass one of th - [POST /accommodations/details/changes](https://developers.booking.com/demand/docs/open-api/demand-api/accommodations/accommodations/details/changes.md): Use this endpoint to track accommodations that have opened, closed, or had relevant content updates since a specific timestamp. Changes can include updates to general information, facilities, rooms, p - [POST /accommodations/reviews](https://developers.booking.com/demand/docs/open-api/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.

✅ The reviews returned can be [filte - [POST /accommodations/reviews/scores](https://developers.booking.com/demand/docs/open-api/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. ## Car rentals - [POST /cars/search](https://developers.booking.com/demand/docs/open-api/demand-api/cars/search.md): Use this endpoint to retrieve the available car rentals matching the search criteria. - [POST /cars/depots](https://developers.booking.com/demand/docs/open-api/demand-api/cars/depots.md): Use this endpoint to retrieve the list of all available car rental depots. - [POST /cars/depots/reviews/scores](https://developers.booking.com/demand/docs/open-api/demand-api/cars/depots/reviews/scores.md): Use this endpoint to return the score breakdown for the specified depots together with the overall number of reviews and score.

- Please note that the **ratings score is based on all travell - [POST /cars/details](https://developers.booking.com/demand/docs/open-api/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/demand-api/cars/suppliers.md): Use this endpoint to fetch a list of car rental suppliers.
You can use a supplier ID (or an array of them), to retrieve specific details.
Alternatively, if you do not add any ID in the reque - [POST /cars/constants](https://developers.booking.com/demand/docs/open-api/demand-api/cars/constants.md): This endpoint returns a list of relevant car constants names in the specified languages. For example, calling with the parameters {"languages":"en-us","fr"} will return the list in English (US) and Fr ## Locations - [POST /common/locations/airports](https://developers.booking.com/demand/docs/open-api/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/demand-api/commonlocations/common/locations/cities.md): This endpoint returns a list of city codes and their names in the selected languages. The cities returned may be filtered by a location id. For example, you can get the list of cities in The Netherlan - [POST /common/locations/countries](https://developers.booking.com/demand/docs/open-api/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/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/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/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/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.

To get the full list call the endpoint - [POST /common/payments/currencies](https://developers.booking.com/demand/docs/open-api/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.

The currency codes returned are what i ## Languages - [POST /common/languages](https://developers.booking.com/demand/docs/open-api/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/demand-api/orders/orders/preview.md): This endpoint returns the total final price with final charges, as well as the price breakdown and payment/cancellation policies for each product passed in the input. - [POST /orders/create](https://developers.booking.com/demand/docs/open-api/demand-api/orders/orders/create.md): Use this endpoint to confirm the booking and proceed the payment. - [POST /orders/details](https://developers.booking.com/demand/docs/open-api/demand-api/orders/orders/details.md): This endpoint returns basic information for orders filtered according to the input. - [POST /orders/details/accommodations](https://developers.booking.com/demand/docs/open-api/demand-api/orders/orders/details/accommodations.md): This endpoint returns all information for given accommodation orders, sorted by `bookingDate` in descending order - [POST /orders/details/cars](https://developers.booking.com/demand/docs/open-api/demand-api/orders/orders/details/cars.md): This endpoint returns car order details, sorted by `bookingDate` in descending order - [POST /orders/details/flights](https://developers.booking.com/demand/docs/open-api/demand-api/orders/orders/details/flights.md): Use this endpoint to retrieve detailed information for one or more flight orders. - You can request car order details either by **order ID** or by **reservation ID**. - The response includes all relev - [POST /orders/modify](https://developers.booking.com/demand/docs/open-api/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/demand-api/orders/orders/cancel.md): Use this endpoint to process an order cancellation. Refer to the [Cancellations guide](/demand/docs/orders-api/cancel-order) for instructions, tips and examples. ## Messages - [POST /messages/send](https://developers.booking.com/demand/docs/open-api/demand-api/messages/sendmessage.md): Sends a message within a conversation. The message body supports plain text. Optionally, attach a file by referencing a previously uploaded attachment ID. - [POST /messages/latest](https://developers.booking.com/demand/docs/open-api/demand-api/messages/fetchlatestmessages.md): Retrieves up to **100 of the most recent messages** including messages from both property and guest.
- Messages are returned in reverse chronological order (newest first). - Use this endpoint to - [POST /messages/latest/confirm](https://developers.booking.com/demand/docs/open-api/demand-api/messages/confirmmessagereceipt.md): Confirms receipt of specified messages. This confirmation is required before receiving new messages from the POST /messages/latest endpoint. ## Conversations - [POST /messages/conversations](https://developers.booking.com/demand/docs/open-api/demand-api/conversations/retrieve-conversation.md): Retrieves a conversation accessible to the authenticated user, including message history and participants. ## Attachments - [POST /messages/attachments/upload](https://developers.booking.com/demand/docs/open-api/demand-api/attachments/uploadattachment.md): Uploads 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/demand-api/attachments/downloadmessageattachment.md): Retrieves a file that was attached to a message. The response includes the file's content as a base64-encoded string. - [POST /messages/attachments/metadata](https://developers.booking.com/demand/docs/open-api/demand-api/attachments/getattachmentmetadata.md): Returns metadata for a file uploaded in a message, including its name, type, and size.