# Booking.com Demand API The Booking.com Demand API enables Demand partners to search, retrieve, preview, create, and manage supported travel-service orders. Demand API v3.3 introduces structural improvements and selected breaking changes compared with v3.2. It also provides car rental booking and post-booking capabilities. The API: * Follows REST principles. * Uses JSON for requests and responses. * Uses HTTPS POST requests for all endpoints. * Requires Demand API authentication using an Affiliate ID and API token. For more information, see the [Try out the API guide](/demand/docs/getting-started/try-out-the-api). Access Booking.com travel services through a single API. Version: 3.3 ## Servers [object Object] ``` https://demandapi.booking.com/3.3 ``` [object Object] ``` https://demandapi-sandbox.booking.com/3.3 ``` ## 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.3/demand-api.yaml) ## Accommodation - [POST /accommodations/search](https://developers.booking.com/demand/docs/open-api/3.3/demand-api/accommodations/accommodations/search.md): Use this endpoint to search for accommodations that match your specified criteria. By default, **the response returns the cheapest available product** for each accommodation.When applying location fil - [POST /accommodations/availability](https://developers.booking.com/demand/docs/open-api/3.3/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.3/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.3/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.3/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.3/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.3/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 [filtered and sort - [POST /accommodations/reviews/scores](https://developers.booking.com/demand/docs/open-api/3.3/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.3/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.3/demand-api/attractions/search.md): Use this endpoint to search for attractions based on a single search criterion, such as attraction IDs, cities, countries, geographic coordinates, or points of interest. - [POST /attractions/details](https://developers.booking.com/demand/docs/open-api/3.3/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/points-of-interest](https://developers.booking.com/demand/docs/open-api/3.3/demand-api/attractions/attractions/points-of-interest.md): Returns points of interest associated with attractions, such as museums and monuments. The response includes localised names, coordinates and links to Booking.com search results. - Use the returned ID - [POST /attractions/reviews](https://developers.booking.com/demand/docs/open-api/3.3/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.3/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.3/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.3/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.3/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.3/demand-api/cars/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.3/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.3/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.3/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.3/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 request, the re - [POST /cars/terms-and-conditions](https://developers.booking.com/demand/docs/open-api/3.3/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.3/demand-api/commonautocomplete/common/autocomplete.md): Returns ranked destination suggestions for a free-text query. Use this endpoint to provide suggestions as a user types. Results are ranked using destination popularity and the supplied country context ## Locations - [POST /common/locations/airports](https://developers.booking.com/demand/docs/open-api/3.3/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.3/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.3/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.3/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.3/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.3/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.3/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 passing a - [POST /common/payments/currencies](https://developers.booking.com/demand/docs/open-api/3.3/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 is used as ## Languages - [POST /common/languages](https://developers.booking.com/demand/docs/open-api/3.3/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.3/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.3/demand-api/orders/orders/create.md): Use this endpoint to create and confirm an order using the `order_token` returned by the relevant preview flow. Include the travel-service details and any payment information required by the selected - [POST /orders/details](https://developers.booking.com/demand/docs/open-api/3.3/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, payment information for invo - [POST /orders/details/accommodations](https://developers.booking.com/demand/docs/open-api/3.3/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.3/demand-api/orders/orders/details/cars.md): Returns enriched, up-to-date car order details for a specific reservation, including vehicle, supplier, pricing, insurance, policy, and driver information. Use this endpoint after creating or cancelli - [POST /orders/details/cars/faq](https://developers.booking.com/demand/docs/open-api/3.3/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/terms-and-conditions](https://developers.booking.com/demand/docs/open-api/3.3/demand-api/orders/cars-terms-and-conditions.md): Retrieve the structured terms and conditions for one or more car rental reservations. The response contains hierarchical legal content organised into chapters, sections, clauses, sub-clauses, and clau - [POST /orders/details/flights](https://developers.booking.com/demand/docs/open-api/3.3/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.3/demand-api/orders/orders/modify.md): Use this endpoint to modify an existing order, including payment card details, check-in and check-out dates, and room configurations for accommodations (guest allocation, guest names and smoking prefe - [POST /orders/modify/preview](https://developers.booking.com/demand/docs/open-api/3.3/demand-api/orders/orders/modify/preview.md): Check whether a requested accommodation date or room allocation change can be applied. For date changes, the response also includes the current and proposed prices. Use this endpoint to: - Check whet - [POST /orders/cancel](https://developers.booking.com/demand/docs/open-api/3.3/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