{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Accommodation order details","siteUrl":"https://developers.booking.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"accommodation-order-details","__idx":0},"children":["Accommodation order details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use /orders/details/accommodations to retrieve detailed information about accommodation bookings, including reservation status, pricing, guest information, cancellation details, and optional property-specific data."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retrieve-accommodation-order-details","__idx":1},"children":["Retrieve accommodation order details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this endpoint to retrieve one or more accommodation orders by ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["order ID"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["reservation ID"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provide one of the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orders"]}," – Retrieve details for up to 100 order IDs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reservations"]}," – Retrieve details for up to 100 reservation IDs."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also customise the response using optional parameters:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns monetary amounts in the requested currency where supported."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extras"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Includes additional information such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accommodation_details"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extra_charges"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns translated content where available. If omitted, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en-gb"]}," is used by default."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language"]}," parameter only affects supported translated fields and does not localise the entire response."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"extras","__idx":2},"children":["Extras"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extras"]}," parameter to enrich the response with additional information."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accommodation_details"]}," – Includes property contact details such as name, address, telephone number, email address, and geographic coordinates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies"]}," – Includes product-level cancellation policies, meal plans, and smoking preferences."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extra_charges"]}," – Extends the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}," object with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["base"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["display"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["charges"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," for a detailed taxes and fees breakdown."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request","__idx":3},"children":["Example request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"currency\": \"USD\",\n  \"extras\": [\n    \"accommodation_details\",\n    \"policies\",\n    \"extra_charges\"\n  ],\n  \"language\": \"fr\",\n  \"reservations\": [\n    \"2444627607\"\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response","__idx":4},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response returns a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," array containing one object for each accommodation order."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common fields include:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"110px"}},"children":["field"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order identifier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reservation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reservation identifier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Current booking status."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkin"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stay dates."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total and commissionable amounts for the order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commission"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Estimated or actual commission information."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pin_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Traveller verification code used for customer support."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Label provided when the order was created, useful for attribution and reporting."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inventory"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates the inventory type (for example, sell or third-party inventory)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accommodation and booker currencies associated with the order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancellation_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancellation timestamp, fee, and original total price when applicable."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accommodation_order_references"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Additional references generated by the accommodation."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["remarks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Traveller remarks captured during booking."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stay_probability"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal prediction score indicating the likelihood that the traveller will stay. A value closer to 1 indicates a higher likelihood of the stay being completed. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["This field may not always be returned"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product-level reservation details."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For eligible properties, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["key_collection_information"]}," may also be returned with check-in instructions, including key location, collection method, and additional guidance."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"product-level-information","__idx":5},"children":["Product-level information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each item in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}," contains information specific to an individual room or booked product, including:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allocation"]}," – Number of guests, adults, and children."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guests"]}," – Guest names and email addresses when available."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["room"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["room_details"]}," – Room identifiers and names."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["room_reservation"]}," – Room-level reservation identifier."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," – Product status."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}," – Pricing details for the product."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies"]}," – Cancellation policy, meal plan, and smoking preference when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extras=policies"]}," is requested."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Did you know?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cancellation policies are returned ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["per product rather than per order"]},", allowing different rooms within the same booking to have different cancellation conditions"," ","See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/cancellation-policies"},"children":["cancellation policies section"]}," for more details."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-response","__idx":6},"children":["Example response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n\"request_id\": \"01fr9ez700exycb98w90w5r9sh\",\n\"data\": [\n  {\n    \"id\": \"509430129718799\",\n    \"accommodation\": 123456,\n    \"accommodation_details\": {\n      \"email\": \"test_hotel@booking.com\",\n      \"location\": {\n        \"address\": \"111 Street Road\",\n        \"city\": 20089219,\n        \"coordinates\": {\n          \"latitude\": 11.923274,\n          \"longitude\": -92.716188\n        },\n        \"country\": \"US\",\n        \"post_code\": \"NY 1234\"\n      },\n      \"name\": \"Test Booking Hotel USA\",\n      \"telephone\": \"+19876543210\"\n    },\n    \"cancellation_details\": {\n      \"at\": \"2025-11-09T00:00:00+00:00\",\n      \"fee\": {\n        \"accommodation_currency\": 170.01,\n        \"booker_currency\": 186.87\n      }\n    },\n    \"checkin\": \"2025-11-10\",\n    \"checkout\": \"2025-11-10\",\n    \"commission\": {...},\n    \"pin_code\": \"1234\",\n    \"price\": {...},\n    \"products\": [...],\n    \"status\": \"booked\"\n  }\n]\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"multi-room-status-precedence","__idx":7},"children":["Multi-room status precedence"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For bookings containing multiple rooms, each product has its own status."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If products within the same order have different statuses, the overall order status follows predefined precedence rules. For example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stayed"]}," takes precedence over other statuses when determining the order-level status."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The status is displayed at both the accommodation and product levels in the response."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"personally-identifiable-information-pii","__idx":8},"children":["Personally Identifiable Information (PII)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Depending on your permissions and agreement with Booking.com, the response may include personally identifiable information (PII), such as:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Guest ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Guest ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker.external_account"]},", which can be used to associate bookings with your own traveller accounts for loyalty programmes or rewards."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"booker\": {\n  \"external_account\": \"13610217\",\n  \"platform\": \"mobile\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If these fields are not returned, your integration may not have the required permissions or configuration enabled."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":9},"children":["Next steps"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Related guides:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Learn how to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/order-preview-create"},"children":["create accommodation orders"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Understand ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/cancellation-policies"},"children":["accommodation cancellation policies"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Learn how to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/cancel-order"},"children":["cancel accommodation orders"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/labels-attributions"},"children":["labels and attribution"]}," for reporting and reconciliation."]}]}]}]},"headings":[{"value":"Accommodation order details","id":"accommodation-order-details","depth":1},{"value":"Retrieve accommodation order details","id":"retrieve-accommodation-order-details","depth":2},{"value":"Extras","id":"extras","depth":3},{"value":"Example request","id":"example-request","depth":3},{"value":"Response","id":"response","depth":2},{"value":"Product-level information","id":"product-level-information","depth":3},{"value":"Example response","id":"example-response","depth":3},{"value":"Multi-room status precedence","id":"multi-room-status-precedence","depth":2},{"value":"Personally Identifiable Information (PII)","id":"personally-identifiable-information-pii","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Accommodation order details"}},"lastModified":"2026-06-15T15:19:05.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/orders-api/order-details-accommodations","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}