# Orders with accommodation details

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 response includes all key information for each order, including booking status, pricing, commission, cancellation details, and optional extras.
- Results are sorted by order creation date in descending order, with the most recently booked orders listed first.

Endpoint: POST /orders/details/accommodations
Version: 3.2
Security: BearerAuth

## Header parameters:

  - `X-Affiliate-Id` (integer, required)
    Include here your Affiliate identifier number

## Response 200 fields (application/json):

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

  - `data` (array)

  - `data.id` (string)
    Order ID for this accommodation order.

  - `data.accommodation` (integer)
    Hotel ID for this accommodation order.

  - `data.accommodation_details` (object)
    Accommodation details for this accommodation order (via 'extras=accommodation_details').

  - `data.accommodation_details.email` (string)
    Accommodation email.

  - `data.accommodation_details.location` (object)
    Accommodation location.

  - `data.accommodation_details.location.address` (string)
    Accommodation address.

  - `data.accommodation_details.location.city` (integer)
    Accommodation city_id.

  - `data.accommodation_details.location.coordinates` (object)
    Accommodation coordinates.

  - `data.accommodation_details.location.coordinates.latitude` (number)
    Accommodation latitude coordinate.

  - `data.accommodation_details.location.coordinates.longitude` (number)
    Accommodation longitude coordinate.

  - `data.accommodation_details.location.country` (string)
    Accommodation country.

  - `data.accommodation_details.location.post_code` (string)
    Accommodation post code.

  - `data.accommodation_details.name` (string)
    Accommodation name.

  - `data.accommodation_details.telephone` (string)
    Accommodation telephone.

  - `data.accommodation_order_references` (array)
    List of additional accommodation order references generated by the accommodation.

  - `data.booker` (object)
    The booker's information.

  - `data.booker.external_account` (string)
    This is a unique identifier that represents the account provided by the partner in Booking.com settings. This field is used to link a specific accommodation order to the corresponding account so is possible to accurately allocate loyalty points or other benefits in the partner's loyalty and rewards programs.

  - `data.booker.platform` (string)
    The booker platform for showing the platform based deals and prices.
    Enum: "app", "desktop", "mobile_browser", "tablet", "unknown"

  - `data.cancellation_details` (object,null)
    Fee charged for cancellation and the datetime at which the cancellation occurred. (If not cancelled, value is null).

  - `data.cancellation_details.at` (string)
    Cancellation datetime.

  - `data.cancellation_details.fee` (object)
    Cancellation fee.

  - `data.cancellation_details.fee.accommodation_currency` (number)

  - `data.cancellation_details.fee.booker_currency` (number)

  - `data.cancellation_details.original_total_price` (object)
    The total amount that would have been charged if this order had not been cancelled. Includes all extra charges.

  - `data.cancellation_details.original_total_price.accommodation_currency` (number)

  - `data.cancellation_details.original_total_price.booker_currency` (number)

  - `data.checkin` (string)
    The checkin date of this accommodation order.

  - `data.checkout` (string)
    The checkout date of this accommodation order.

  - `data.commission` (object)
    Commission details for the partner for this accommodation order.

  - `data.commission.actual_amount` (object,null)
    Actual commission amount for this accommodation order (null if value is not yet available).

  - `data.commission.actual_amount.accommodation_currency` (number)

  - `data.commission.actual_amount.booker_currency` (number)

  - `data.commission.actual_percentage` (number,null)
    Actual commission percentage for this accommodation order (null if value is not yet available).

  - `data.commission.estimated_amount` (object,null)
    Estimated commission amount for this accommodation order (null if the actual amount is given).

  - `data.commission.estimated_amount.accommodation_currency` (number)

  - `data.commission.estimated_amount.booker_currency` (number)

  - `data.credit_slip_number` (string,null)
    The financial document issued by Booking.com to partners, detailing the payout amount and the associated transaction information. It serves as a formal record of the payment, ensuring transparency and facilitating accurate financial tracking for both parties.

  - `data.currency` (object)
    Accommodation and booker currencies (booker will be null, if the request did not specify the currency).

  - `data.currency.accommodation` (string)
    A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling common/payments/currencies.

  - `data.currency.booker` (string,null)
    A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling common/payments/currencies.

  - `data.inventory` (object)

  - `data.inventory.third_party` (boolean)
    Boolean value is "true" if the product is facilitated by a Booking.com partner company and "false" otherwise.

  - `data.inventory.type` (string)
    Type of inventory - either net or sell rates.
    Enum: "net", "sell"

  - `data.key_collection_information` (array,null)

  - `data.key_collection_information.additional_instructions` (string)
    Free-text instructions that provide additional context or details about the key collection or check-in process, such as access codes, entry procedures, or contact information.

  - `data.key_collection_information.alternate_location` (object)
    This is the alternate location where the key for this accommodation property can be collected. It is provided if the key is not available at the accommodation property itself but instead at another designated location.

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

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

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

  - `data.key_collection_information.checkin_method` (string)
    An enumeration that describes the check-in process and key collection method. This is typically applicable to non-hotel accommodations (such as houses or apartments) that do not have a 24-hour front desk.
    Enum: "door_code", "lock_box", "reception", "secret_spot", "someone_will_meet", "unknown"

  - `data.key_collection_information.key_location` (string)
    Location of the key to access this accommodation property.
    Enum: "at_the_property", "different_place", "unknown"

  - `data.label` (string,null)
    Label provided when the accommodation order was created.

  - `data.pin_code` (string)
    The pin code of this accommodation order.

  - `data.price` (object,null)
    The price components of this accommodation order.

  - `data.price.commissionable` (object,null)
    The commissionable price. Reservation price on which commission amount is calculated.

  - `data.price.commissionable.accommodation_currency` (number)

  - `data.price.commissionable.booker_currency` (number)

  - `data.price.total` (object)
    The total price. Includes all extra charges.

  - `data.price.total.accommodation_currency` (number)

  - `data.price.total.booker_currency` (number)

  - `data.products` (array)

  - `data.products.allocation` (object)
    The allocation of guests, adults and children for this product.

  - `data.products.allocation.guests` (integer)
    The number of guests reserved for this product.

  - `data.products.allocation.adults` (integer,null)
    The number of adults reserved for this product.

  - `data.products.allocation.children` (array)
    The list of ages of all children reserved for this product.

  - `data.products.bundle` (object)
    A bundle attached to the reservation that includes information about the value-added service in the specified language.

  - `data.products.bundle.id` (integer)
    Bundle identifier

  - `data.products.bundle.value_adds` (array)

  - `data.products.bundle.value_adds.type` (string)
    Identifies the type of value-added benefit included in the bundle, such as complimentary services, monetary credits, percentage discounts, or experiential amenities. Enum values encode how the benefit is applied, including time scope (per day or per stay) and unit scope (per room or per adult).
    Enum: "parking", "food_drink_credit_per_day_per_room", "food_drink_credit_per_day_per_adult", "property_credit_per_day_per_room", "food_drink_credit_per_stay_per_adult", "food_drink_credit_per_stay_per_room", "property_credit_per_day_per_adult", "property_credit_per_stay_per_adult", "property_credit_per_stay_per_room", "food_drink_discount", "property_discount", "early_checkin", "late_checkout", "late_checkin", "spa_daily", "spa_hourly", "spa_massage", "high_speed_internet", "airport_transfer", "safari_game_drive", "safari_walk", "pets_stay", "bottle_of_wine", "bottle_of_champagne", "park_sleep_fly"

  - `data.products.bundle.value_adds.description` (array)
    Translated descriptive text in the requested language.

  - `data.products.guests` (array)
    The guest details for this product.

  - `data.products.guests.email` (string,null)
    The email address of the guest.

  - `data.products.guests.name` (string)
    The name of the guest.

  - `data.products.policies` (object)
    The policies for this product. Requires {"extras":["policies"]}.

  - `data.products.policies.cancellation` (array,null)
    The cancellation policy schedule for this product.

  - `data.products.policies.cancellation.from` (any)
    The time from which this cancellation fee applies.

  - `data.products.policies.cancellation.price` (object)
    The cancellation fee.

  - `data.products.policies.cancellation.price.accommodation_currency` (number)

  - `data.products.policies.cancellation.price.booker_currency` (number)

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

  - `data.products.policies.meal_plan.meals` (array)
    The meals included in the meal plan.
    Enum: "breakfast", "dinner", "lunch"

  - `data.products.policies.meal_plan.plan` (string)
    The meal plan included in this product.
    Enum: "all_inclusive", "breakfast_included", "full_board", "half_board", "no_plan"

  - `data.products.policies.smoking_preference` (string,null)
    Smoking Preference for this product.
    Enum: "smoking", "non-smoking"

  - `data.products.price` (object)
    The price components of this product. 'base', 'display', and 'charges' are returned only when explicitly requested (via 'extras=extra_charges'). Note: chargeable_online field is not available in this endpoint.

  - `data.products.price.base` (object,null)
    The base price. It does not include any extra charges.

  - `data.products.price.base.accommodation_currency` (number)

  - `data.products.price.base.booker_currency` (number)

  - `data.products.price.display` (object,null)
    The display price that must be shown to the traveller under local booker protection laws. Equivalent to base + charges where included_in.display=true.

  - `data.products.price.display.accommodation_currency` (number)

  - `data.products.price.display.booker_currency` (number)

  - `data.products.price.charges` (array)
    The charge breakdown. Includes taxes and fees.

  - `data.products.price.charges.charge` (integer)
    A signed integer number that uniquely identifies an accommodation charge type. Examples of charges are: VAT, City Tax, etc. The full list can be obtained by calling accommodations/constants.

  - `data.products.price.charges.mode` (string)
    The mode of this charge. Determines how the price is calculated.
    Enum: "calculated_amount", "incalculable", "percentage", "per_day", "per_night", "per_person_per_day", "per_person_per_night", "per_person_per_stay", "per_stay"

  - `data.products.price.charges.percentage` (number,null)
    The percentage of 'base' that this charge amounts to. Only applicable when 'mode' is 'percentage'.

  - `data.products.price.charges.total_amount` (object)
    The price in both accommodation and booker currencies (booker might be null, if not requested)

  - `data.products.price.charges.total_amount.accommodation_currency` (number)

  - `data.products.price.charges.total_amount.booker_currency` (number)

  - `data.products.price.charges.unit_amount` (object,null)
    The price in both accommodation and booker currencies (booker might be null, if not requested)

  - `data.products.price.charges.unit_amount.accommodation_currency` (number)

  - `data.products.price.charges.unit_amount.booker_currency` (number)

  - `data.products.price.charges.condition` (integer,null)
    Specifies the condition under which this charge applies. Returns null if the charge is not conditional.

  - `data.products.price.charges.included_in` (object)
    Indicates where this charge is included. Note: chargeable_online is not available in this endpoint.

  - `data.products.price.charges.included_in.display` (boolean)
    Indicates if this charge is included in the display price.

  - `data.products.price.total` (object,null)
    The total price. Includes all extra charges.

  - `data.products.price.total.accommodation_currency` (number)

  - `data.products.price.total.booker_currency` (number)

  - `data.products.room` (string)
    A unique identifier for a specific room within an accommodation property. You can retrieve the full list of available room IDs by calling [accommodations/details](/demand/docs/open-api/demand-api/accommodations/accommodations/details).

  - `data.products.room_details` (object)
    Room details for this product (via 'extras=accommodation_details').

  - `data.products.room_details.name` (string)
    The room name given to this product.

  - `data.products.room_reservation` (string)
    The room reservation id given to this product.

  - `data.products.status` (string)
    Status of the product.
    Enum: "booked", "cancelled", "cancelled_by_accommodation", "cancelled_by_guest", "no_show", "stayed"

  - `data.reservation` (string)
    Reservation ID for given accommodation order.

  - `data.remarks` (string)
    Guest remarks added while creating order.

  - `data.status` (string)
    Status of this accommodation order.
    Enum: "booked", "cancelled", "cancelled_by_accommodation", "cancelled_by_guest", "no_show", "stayed"

  - `data.stay_probability` (number,null)
    Score that predicts the likelihood of a traveller's intent to stay, based on internal calculations. A score of 0 indicates the highest likelihood of cancellation, while a score of 1 represents the highest likelihood of the traveller staying. Note: This score may not always be available.

## Response 400 fields (application/json):

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

  - `errors` (array, required)

  - `errors.id` (string, required)

  - `errors.message` (string, required)

## Response 500 fields (application/json):

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

  - `errors` (array, required)

  - `errors.id` (string, required)

  - `errors.message` (string, required)