# List accommodation details

This endpoint returns detailed information on all accommodation properties matching a given search criteria.
By default, only basic information is returned. To receive extended information use the extras parameter.
Is is mandatory to pass one of the input parameters: accommodations, airport, city, country or region.

Endpoint: POST /demand-api-v3-compatible/accommodations/details
Version: 1.1
Security: BearerAuth

## Header parameters:

  - `Accept` (string)
    Enum: "application/json"

## Request fields (application/json):

  - `accommodations` (array)
    A signed integer number that uniquely identifies an accommodation property.

  - `accommodation_facilities` (array)
    A signed integer number that uniquely identifies an accommodation property facility.
Examples of facilities are: Parking, Restaurant, Room service etc.

  - `accommodation_types` (array)
    A signed integer number that uniquely identifies an accommodation property type.
Examples of accommodation types are: Apartment, Hostel, Hotel etc.

  - `airport` (string)
    A three-letter code that uniquely identifies an airport as defined by the International Air Transport Association (IATA).
    Example: "AMS"

  - `brands` (array)
    A signed integer number that uniquely identifies an accommodation brand.
Examples of brands are: Radisson Blu, WestCord Hotels, Westin etc.

  - `city` (integer)
    A signed integer number that uniquely identifies a city.

  - `country` (string)
    A two-letter code that uniquely identifies a country.
This code is defined by the ISO 3166-1 alpha-2 standard (ISO2) as described here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2.
    Example: "nl"

  - `region` (integer)
    A signed integer number that uniquely identifies a geographical region.
Regions usually define official administrative areas within a country,
but may also include multiple countries and in some cases un-official but popular designations for geographical areas.
An example of a region that crosses multiple countries is the Alps in Europe.

  - `extras` (array)
    Input parameter to request for additional information about the accommodation property.
It should be passed as a JSON array with one or more items.
    Enum: "DESCRIPTION", "FACILITIES", "PAYMENT", "PHOTOS", "POLICIES", "ROOMS"

  - `languages` (array)
    An IETF language tag code that uniquely identifies a supported human language or dialect as described here:
https://en.wikipedia.org/wiki/IETF_language_tag.

Note that in in demand-api-v3-compatible the whole tag is always lowercase.
Examples: "nl" for Dutch/Nederlands or "en-us" for English (US).
    Enum: "ar", "bg", "ca", "cs", "da", "de", "el", "en", "en-gb", "en-us", "es", "es-ar", "es-mx", "et", "fi", "fr", "he", "hi", "hr", "hu", "id", "is", "it", "ja", "ka", "ko", "lt", "lv", "ms", "nl", "no", "pl", "pt-br", "pt-pt", "pt", "ro", "ru", "sk", "sl", "sr", "sv", "th", "tl", "tr", "uk", "vi", "zh", "zh-cn", "zh-tw"

  - `rows` (integer)
    The maximum number of results to return.

  - `page` (string)
    Pagination token used to retrieve the next page of results. Obtained from next_page.

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (integer)
    A signed integer number that uniquely identifies an accommodation property.

  - `data.name` (object)
    Translated description of this room. The maximum number of characters returned may be limited by contract.

  - `data.name.translations` (object)

  - `data.accommodation_type` (integer)
    A signed integer number that uniquely identifies an accommodation property type.
Examples of accommodation types are: Apartment, Hostel, Hotel etc.

  - `data.brands` (array)
    A signed integer number that uniquely identifies an accommodation brand.

  - `data.checkin_checkout_times` (object)

  - `data.checkin_checkout_times.checkin_from` (object)
    The time till when checkout can be done at this property.

  - `data.checkin_checkout_times.checkin_from.hour` (integer)

  - `data.checkin_checkout_times.checkin_from.minute` (integer)

  - `data.checkin_checkout_times.checkin_from.second` (integer)

  - `data.checkin_checkout_times.checkin_from.nano` (integer)

  - `data.checkin_checkout_times.checkin_to` (object)
    The time till when checkout can be done at this property.

  - `data.checkin_checkout_times.checkout_from` (object)
    The time till when checkout can be done at this property.

  - `data.checkin_checkout_times.checkout_to` (object)
    The time till when checkout can be done at this property.

  - `data.contacts` (object)
    Contact information of the accommodation.

  - `data.contacts.general` (object)
    Contact information of the accommodation. It can be null if the data is missing.

  - `data.contacts.general.email` (object)
    Email address of the accommodation. It can be null if the data is missing.

  - `data.contacts.general.telephone` (object)
    Telephone number of the accommodation. It can be null if the data is missing.

  - `data.contacts.reservations` (object)
    Contact information of the accommodation. It can be null if the data is missing.

  - `data.currency` (string)
    A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard.
    Example: "EUR"

  - `data.facilities` (array)
    The list of facilities available in this property. Requires {"extras":["facilities"]}.

  - `data.facilities.id` (integer)
    A signed integer number that uniquely identifies an accommodation property facility.
Examples of facilities are: Parking, Restaurant, Room service etc.

  - `data.facilities.attributes` (array)
    List of optional attributes for this facility.
    Enum: "OFFSITE", "PAID"

  - `data.deep_link_url` (string)
    Deep link mobile app URL.

  - `data.description` (object)
    Textual information about the accommodation. Requires {"extras":["description"]}.

  - `data.description.important_information` (object)
    Text containing important information about the property. The value is translated in the requested languages.

  - `data.description.important_information.translated_string` (object)
    Translated description of this room. The maximum number of characters returned may be limited by contract.

  - `data.description.important_information.non_lazy_translations` (object)

  - `data.description.license_numbers` (array)
    List of all the license numbers of this accommodation property.

  - `data.description.text` (object)
    The translated description text of this accommodation property in the requested languages.
The maximum number of characters returned may be limited by contract.

  - `data.description.text.truncate` (boolean)

  - `data.is_work_friendly` (boolean)
    Flags if this accommodation is work friendly.

  - `data.key_collection_information` (array)

  - `data.key_collection_information.alternate_location` (object)
    Alternate location to collect the key of this accommodation property.
This is returned if the key to access the property is in another location.

  - `data.key_collection_information.alternate_location.address` (object)

  - `data.key_collection_information.alternate_location.city` (object)

  - `data.key_collection_information.alternate_location.postal_code` (string)

  - `data.key_collection_information.checkin_method` (string)
    An enumeration that describes the conditions for the checkin process and for collecting the key to access the property.
This is typically relevant for non-hotel accommodations (like houses or apartments) without a 24 hours front-desk.

  - `data.key_collection_information.key_location` (string)
    Location of the key to access this accommodation property.

  - `data.location` (object)
    All location related information of this accommodation property.

  - `data.location.address` (object)
    Translated accommodation address.

  - `data.location.address.fallback` (string)

  - `data.location.city` (integer)
    A signed integer number that uniquely identifies a city.

  - `data.location.coordinates` (object)
    A signed integer number that uniquely identifies a city.

  - `data.location.coordinates.latitude` (number)
    Latitude.
    Example: 52.375859

  - `data.location.coordinates.longitude` (number)
    Longitude.
    Example: 4.886006

  - `data.location.country` (string)
    A two-letter code that uniquely identifies a country.
This code is defined by the ISO 3166-1 alpha-2 standard (ISO2) as described here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2.

  - `data.location.districts` (array)
    A signed integer number that uniquely identifies a district. Typically, districts define known areas within a city.

  - `data.location.regions` (array)
    A signed integer number that uniquely identifies a geographical region.
Regions usually define official administrative areas within a country,
but may also include multiple countries and in some cases un-official but popular designations for geographical areas.
An example of a region that crosses multiple countries is the Alps in Europe.

  - `data.number_of_rooms` (integer)
    Total number of rooms in the property.
Please note that this is not an availability call and that this number is mostly used to determine the size and type of a property.

  - `data.payment` (object)
    Payment terms and conditions for this product.

  - `data.payment.payment_types` (array)
    Enum: "PAY_LATER", "PAY_NOW"

  - `data.photos` (array)
    List of photos for this accommodation property.The maximum number of photos returned may be limited by contract.
Requires {"extras":["photos"]}. The photos are returned in no particular order.

  - `data.photos.main_photo` (boolean)
    Flags this as the main photo. Not returned otherwise.

  - `data.photos.tags` (array)
    A list of tags associated with the photo. Manually generated.

  - `data.photos.url` (object)

  - `data.photos.url.large` (string)
    URL of the photo image with a maximum width of 1280 pixels.

  - `data.photos.url.standard` (string)
    URL of the photo image with a maximum width of 500 pixels.

  - `data.photos.url.thumbnail` (string)
    URL of the photo thumbnail image with dimensions 100x100 pixels.

  - `data.photos.url.thumbnail_large` (string)
    URL of the photo thumbnail image with dimensions 300x300 pixels.

  - `data.policies` (object)
    The policies for this product.

  - `data.policies.cancellation` (object)
    The cancellation policy for this product.

  - `data.policies.cancellation.free_cancellation_until` (string)
    Until when the order for this product can be cancelled for free.

  - `data.policies.cancellation.type` (string)
    The cancellation scheme supported by this product.
    Enum: "FREE_CANCELLATION", "NON_REFUNDABLE", "SPECIAL_CONDITIONS"

  - `data.policies.meal_plan` (object)
    The meal plan policy for this product.

  - `data.policies.meal_plan.meals` (array)
    The meals included in the meal plan.
    Enum: "BREAKFAST", "DINNER", "LUNCH"

  - `data.policies.meal_plan.plan` (string)
    The meal plan included in this product.
    Enum: "ALL_INCLUSIVE", "BREAKFAST_INCLUDED", "FULL_BOARD", "HALF_BOARD", "NO_PLAN"

  - `data.price_category` (string)
    Indicates the qualitative price reference (between $ and $$$$) on how expensive an accommodation is.
Accommodations in the same city are sorted by ascending price (average per guest per night in the last month),
the ones in the lowest 25 percentile are in category $, between 25 and 50 percentile are in category $$,
between 50 and 75 percentile are in category $$$, remaining ones are in category $$$$.

  - `data.programmes` (object)
    Details of programmes undergone by the property.

  - `data.programmes.travel_proud` (boolean)
    Boolean value is "true" if property has travel proud badge and "false" otherwise.

  - `data.rating` (object)

  - `data.rating.number_of_reviews` (integer)
    Number of validated reviews for this accommodation.

  - `data.rating.preferred` (boolean)
    Boolean value is "true" if this accommodation is in the Booking.com's preferred program and "false" otherwise.

  - `data.rating.review_score` (number)
    A decimal number indicating the current review score of this accommodation property, in the range 1..10.

  - `data.rating.stars` (number)
    Number of stars of this accommodation property.
    Example: 4

  - `data.rating.stars_type` (string)
    An enumerated value describing which type of stars this accommodation has.
    Enum: "ESTIMATED_BY_ACCOMMODATION", "ESTIMATED_BY_BOOKING", "OFFICIAL"

  - `data.rooms` (array)
    The list of room types available at this property. Requires {"extras":["rooms"]}.

  - `data.rooms.id` (integer)
    A signed integer number that uniquely identifies an accommodation property room.

  - `data.rooms.attributes` (array)
    Lists a set of attribute qualifiers for this room. Will not be returned if no relevant attributes are applicable.
    Enum: "NON_SMOKING", "WORK_FRIENDLY"

  - `data.rooms.bed_options` (array)
    Lists all possible bedding options for this room or apartment.

  - `data.rooms.bed_options.bed_configurations` (array)
    Lists all alternative bed configurations that are supported.

  - `data.rooms.bed_options.bed_configurations.id` (string)
    Uniquely identifies this bed configuration.

  - `data.rooms.bed_options.bed_configurations.configuration` (array)
    Detail list of all different types and number of beds included in this configuration.

  - `data.rooms.bed_options.bed_configurations.configuration.bed_type` (integer)
    A signed integer number that uniquely identifies a bed type. Examples of bed types are: Single, Double etc.

  - `data.rooms.bed_options.bed_configurations.configuration.number_of_beds` (integer)
    Number of similar beds included in this configuration.

  - `data.rooms.bed_options.has_bathroom` (boolean)
    Flags if this area includes its own bathroom.

  - `data.rooms.bed_options.is_bedroom` (boolean)
    Flags if this area is marked as a bedroom, otherwise, it should be considered a living room.

  - `data.rooms.cribs_and_extra_beds` (object)
    Lists room options regarding adding cribs and/or extra beds.

  - `data.rooms.cribs_and_extra_beds.are_allowed` (boolean)
    Flags if cots and extra beds can be placed together in the room.
true allows both up to their maximum limits. false requires exclusive choice of either cots or extra beds.

  - `data.rooms.cribs_and_extra_beds.maximum_number_of_cribs` (integer)
    Maximum number of cribs that can be added.

  - `data.rooms.cribs_and_extra_beds.maximum_number_of_extra_beds` (integer)
    Maximum number of extra beds that can be added.

  - `data.rooms.description` (object)
    Translated description of this room. The maximum number of characters returned may be limited by contract.

  - `data.rooms.facilities` (array)
    A signed integer number that uniquely identifies an accommodation property room facility.
Examples of facilities are: Coffee/Tea maker, TV, Airconditioning, etc.

  - `data.rooms.maximum_occupancy` (object)
    Occupancy limits and options.

  - `data.rooms.maximum_occupancy.adults` (integer)
    Maximum number of adults allowed.

  - `data.rooms.maximum_occupancy.children` (integer)
    Maximum number of children allowed (children will be typically defined by being under 18 years of age).

  - `data.rooms.maximum_occupancy.total_guests` (integer)
    DEPRECATED Total capacity of adults + children allowed.

  - `data.rooms.number_of_rooms` (object)
    Total rooms available.

  - `data.rooms.number_of_rooms.bathrooms` (integer)

  - `data.rooms.number_of_rooms.bedrooms` (integer)

  - `data.rooms.number_of_rooms.living_rooms` (integer)

  - `data.rooms.room_type` (integer)
    A signed integer number that uniquely identifies an accommodation property room type.
Example of room types are: Suite, Apartment, Twin/Double etc.

  - `data.rooms.size` (integer)
    The room area in square meters.
    Example: 20

  - `data.spoken_languages` (array)

  - `data.themes` (array)

  - `request_id` (string)
    Uniquely identifies the request. Please provide this identifier when contacting support.

  - `next_page` (string)
    Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter page).