# About accommodations **Enable travellers to easily find and choose the properties they want to book.** ## The /accommodations API collection The /accommodations API is a subset of Demand API endpoints that provides functionality specific to the accommodations sector of the travel market. The API gives your application access to Booking.com's extensive inventory of properties, covering many different destinations and types of property. You will need to use /accommodations endpoints if your application implements any of the following integration types. ![accommodations flow diagram](/assets/about-accommodations.b96b4200056af49bd3e7aff8d6ef47ff8d58edb0461c26825a6f28657e4decb6.4302f616.png) ## Endpoints The /accommodations endpoints provide all the information your application needs to: 1. Help travellers easily find and choose the properties they want to book. 2. Redirect them to Booking.com to make their booking. (Or, if you also use the [/orders API](/demand/docs/orders-api/overview/), you can process and manage bookings yourself.) The following sections briefly describe the available endpoints and their purpose. ### Search, availability and pricing Find available properties and products that match a traveller's requirements (their destination, dates and guests): * [/accommodations/search](/demand/docs/open-api/demand-api/accommodations/accommodations/search) - Get a list of properties that have availability matching a traveller's requirements, and return each property's best available price. For more information about how to use this endpoint, see [Search for available properties](/demand/docs/accommodations/search-for-available-properties/). * [/accommodations/availability](/demand/docs/open-api/demand-api/accommodations/accommodations/availability) - Return price and availability details for all of a property's products that match a traveller's requirements. ### Property details Get all the information about a property that a traveller might want to know - from basic details such as its name and address, photos, to opening hours, what types of payment it accepts, what facilities it has, room details and so on: * [/accommodations/details](/demand/docs/open-api/demand-api/accommodations/accommodations/details) - Get complete information about one or more properties. * [accommodations/details/changes](/demand/docs/open-api/demand-api/accommodations/accommodations/details/changes) - List properties that have opened, closed, or updated their details after a particular time in the last 24 hours. ### Accommodation identifiers Get the mappings of identifiers to names for data that is specifically related to accommodations, so that you can map names to identifiers in requests, and identifiers to names in responses: * [/accommodations/chains](/demand/docs/open-api/demand-api/accommodations/accommodations/chains) - List the unique identifiers and associated names of property chains and brands. * [/accommodations/constants](/demand/docs/open-api/demand-api/accommodations/accommodations/constants) - List the unique identifiers and associated names of different data types used with properties - for example, room facilities such as "Tea/Coffee maker", or property types such as "Bed and breakfasts". ### Reviews Get reviews from previous guests and statistical ratings for properties, to help your travellers gauge their quality: * [/accommodations/reviews](/demand/docs/open-api/demand-api/accommodations/accommodations/reviews) - List review comments for properties. * [/accommodations/reviews/scores](/demand/docs/open-api/demand-api/accommodations/accommodations/reviews/scores) - List statistical review scores for properties, in both individual categories and overall. Note You can only use the [/accommodations/reviews](/demand/docs/open-api/demand-api/accommodations/accommodations/reviews) and [/accommodations/reviews/scores](/demand/docs/open-api/demand-api/accommodations/accommodations/reviews/scores) endpoints if your partner agreement with Booking.com allows it. ## Features ### Extensive filtering capabilities The /accommodations endpoints provide extensive filtering capabilities that you can use to tailor and optimise your searches to suit both your business model and the traveller's requirements. For example: * You can restrict your property searches in different ways, such as by location (country, city, region, proximity to an airport), type, brand, payment type, etc. * See [Destination fields](/demand/docs/accommodations/search-for-available-properties/#destination-fields) and [Filter criteria](/demand/docs/accommodations/search-for-available-properties/#filter-criteria) for more details of the filtering capabilities provided by [/accommodations/search](/demand/docs/open-api/demand-api/accommodations/accommodations/search). ### Tailored output By default, all endpoints return basic data that will always be needed. However, you can optionally use the `extras` field in your request to retrieve additional information in the following endpoints: * [/accommodations/search](/demand/docs/open-api/demand-api/accommodations/accommodations/search), * [/accommodations/availability](/demand/docs/open-api/demand-api/accommodations/accommodations/availability) * [/accommodations/details](/demand/docs/open-api/demand-api/accommodations/accommodations/details) #### Example of tailored output For example, on an [/accommodations/details](/demand/docs/open-api/demand-api/accommodations/accommodations/details) call you can optionally return any combination of the following information about a property: photos, additional description, details of facilities, accepted payment methods, meal and cancellation policies, and room details. If your application provides detailed property pages you may want all of this information; if you just present summary details about properties, you may just want photos, or none of it. ## Guides div div h3 🚀 Quick guide ul li strong Purpose: Fast setup to search, get details, and retrieve availability. li strong When to use: You’re not familiar with the Accommodation APIs or need to test quickly. li strong Content: ol li Prerequisites li /accommodations/search li /accommodations/details li /accommodations/availability li Booking options overview li strong Code samples: Minimal, only required fields. li strong Estimated time to complete: 10–15 minutes. li strong Link: a Read quick guide div h3 📚 Full tutorial - Step-by-step with examples ul li strong Purpose: Complete step-by-step scenario from search to booking with explanations. li strong When to use: You’re new to the API or want to see how all endpoints connect in a real booking flow. li strong Content: ol li Prerequisites li Search & Look flow li Search, Look & Book flow li Orders API deep dive (preview, create, cancellation) li Payment breakdowns li strong Code samples: Full request/response bodies with annotations and use case context. li strong Estimated time to complete: 45–60 minutes. li strong Link: a Read full tutorial