# Accommodation order details

**Use /orders/details/accommodations to retrieve post-booking detailed information about one or more accommodation orders, including order status, pricing, guest information, cancellation details and optional property-specific data.**

## Retrieve accommodation order details

Use [/orders/details/accommodations endpoint](/demand/docs/open-api/3.2/demand-api/orders/orders/details/accommodations) to retrieve accommodation order details by order ID or reservation ID.

Provide one of the following request fields:

* `orders` — Retrieves details for up to 100 order IDs.
* `reservations` — Retrieves details for up to 100 reservation IDs.


You can also include these optional fields:

| Field | Description |
|  --- | --- |
| `currency` | Returns monetary amounts in the requested currency where supported. |
| `extras` | Requests additional information, such as accommodation details, policies or extra charges. |
| `language` | Requests translated content where available. The default language depends on the request type and configured settings. |


The `language` property only affects fields that support translation. It does not localise the entire response.

## Request additional information

Use the `extras` property to request additional information in the response.

* `accommodation_details` — Returns property contact details, including the name, address, telephone number, email address and geographic coordinates.
* `policies` — Returns product-level cancellation policies, meal-plan information and smoking preferences.
* `extra_charges` — Returns the `base`, `display`, `charges` and `total` properties in the product-level `price` object.


### Example request

```json
{
  "currency": "USD",
  "extras": [
    "accommodation_details",
    "policies",
    "extra_charges"
  ],
  "language": "fr",
  "reservations": [
    "2444627607"
  ]
}
```

## Response

The response contains a `data` array with one object for each accommodation order.

| Field | Description |
|  --- | --- |
| `id` | Order ID. |
| `reservation` | Reservation ID. |
| `accommodation` | Accommodation ID. |
| `accommodation_details` | Property details returned when `extras` includes `accommodation_details`. |
| `status` | Current status of the accommodation order. |
| `checkin` and `checkout` | Check-in and check-out dates. |
| `price` | Commissionable and total order prices. |
| `commission` | Estimated or actual commission information. |
| `currency` | Accommodation and booker currencies. |
| `inventory` | Indicates the inventory type, including whether the order uses third-party inventory. |
| `third_party_inventory` | Third-party inventory information, including the `checkin_number` when available. |
| `cancellation_details` | Cancellation date and time, cancellation fee and original total price. This property is `null` when the order has not been cancelled. |
| `accommodation_order_references` | Additional references generated by the accommodation. |
| `booker` | Booker platform and external account information when available. |
| `remarks` | Remarks added when the order was created. |
| `label` | Label provided when the order was created. |
| `pin_code` | PIN code associated with the accommodation order. |
| `stay_probability` | Internal score predicting the likelihood that the traveller will stay. A value of `0` indicates the highest likelihood of cancellation and a value of `1` indicates the highest likelihood of staying. This field may not be returned. |
| `key_collection_information` | Key collection and check-in instructions when provided by the accommodation. |
| `products` | Product-level information for each reserved room or accommodation product. |


### Third-party inventory

For orders using third-party inventory rates:

* `inventory.third_party` is `true`.
* `third_party_inventory` may contain third-party-specific information.
* `checkin_number` contains the number required at check-in when it is available.


For orders that do not use third-party inventory, `inventory.third_party` is `false`.

### Accommodation details

The `accommodation_details` field is returned when `extras` includes `accommodation_details`.

It can contain:

* Property name, email address and telephone number.
* Address, city and post code.
* Latitude and longitude coordinates.


### Key collection information

For eligible properties, `key_collection_information` may contain instructions for accessing the accommodation.

Each item can include:

* `checkin_method` — The check-in and key collection method.
* `key_location` — The location of the key.
* `alternate_location` — An alternate location where guests can collect the key.
* `additional_instructions` — Additional access or check-in instructions.


## Product-level information

Each item in `products` represents a reserved room or accommodation product.

| Field | Description |
|  --- | --- |
| `allocation` | Number of guests, adults and children. The `children` array contains the ages of the children. |
| `guests` | Guest names and email addresses when available. |
| `room` | Room ID. |
| `room_details` | Room name returned when accommodation details are requested. |
| `room_reservation` | Room-level reservation ID. |
| `status` | Current status of the product. |
| `price` | Product price information. |
| `policies` | Cancellation policy, meal-plan information and smoking preference when `extras` includes `policies`. |
| `bundle` | Reserved bundle information when applicable. |


Cancellation policies are returned at product level. Different products within the same accommodation order may therefore have different cancellation conditions.

See [Cancellation policies](/demand/docs/orders-api/cancellation-policies) for more information.

## Prices and charges

The order-level `price` object contains:

* `commissionable` — The price used to calculate commission.
* `total` — The total price, including extra charges.


When `extras` includes `extra_charges`, the product-level `price` object can also contain:

* `base` — The base price, excluding extra charges.
* `display` — The price shown to the traveller under applicable local requirements.
* `charges` — A breakdown of taxes and fees.
* `total` — The total price, including extra charges.


All monetary values can include both `accommodation_currency` and `booker_currency`.

## Example response: non-third-party inventory

```json
{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": [
    {
      "id": "509430129718800",
      "accommodation": 123456,
      "accommodation_order_references": [
        "12345",
        "ABED2312"
      ],
      "currency": {
        "accommodation": "EUR",
        "booker": "USD"
      },
      "inventory": {
        "third_party": false,
        "type": "sell"
      },
      "third_party_inventory": null,
      "reservation": "12345678",
      "status": "booked",
      "checkin": "2025-12-10",
      "checkout": "2025-12-18",
      "label": "One123",
      "pin_code": "1234",
      "remarks": "We will need an extra cot.",
      "stay_probability": 0.12,
      "products": [
        {
          "allocation": {
            "adults": 2,
            "children": [
              3,
              4,
              5
            ],
            "guests": 5
          },
          "guests": [
            {
              "email": "test.name@example.com",
              "name": "Test Name"
            }
          ],
          "room": "12345",
          "room_details": {
            "name": "Double Deluxe Room"
          },
          "room_reservation": "1234567890",
          "status": "booked"
        }
      ]
    }
  ]
}
```

## Example response: third-party inventory

```json
{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": [
    {
      "id": "509430129718799",
      "accommodation": 123456,
      "currency": {
        "accommodation": "EUR",
        "booker": "USD"
      },
      "inventory": {
        "third_party": true,
        "type": "sell"
      },
      "third_party_inventory": {
        "checkin_number": "CHK-123456"
      },
      "reservation": "12345678",
      "status": "booked",
      "checkin": "2025-12-10",
      "checkout": "2025-12-18",
      "products": [
        {
          "allocation": {
            "adults": 2,
            "children": [],
            "guests": 2
          },
          "room": "12345",
          "room_reservation": "1234567890",
          "status": "booked"
        }
      ]
    }
  ]
}
```

## Personally identifiable information

Depending on your permissions and agreement with Booking.com, the response may include personally identifiable information, such as:

* `products.guests[].name`
* `products.guests[].email`
* `booker.external_account`


The `booker.external_account` field identifies the external account provided in your Booking.com settings. You can use it to associate the order with a traveller account in your loyalty or rewards programme.

```json
"booker": {
  "external_account": "13610217",
  "platform": "mobile"
}
```

If these properties are not returned, your integration may not have the required permissions or configuration enabled.

## Next steps

Related guides:

* Learn how to [create accommodation orders](/demand/docs/orders-api/order-preview-create).
* Understand [accommodation cancellation policies](/demand/docs/orders-api/cancellation-policies).
* Learn how to [cancel accommodation orders](/demand/docs/orders-api/cancel-order).
* Use [labels and attribution](/demand/docs/orders-api/labels-attributions) for reporting and reconciliation.