# Accommodation order details

**Use /orders/details/accommodations to retrieve detailed information about accommodation bookings, including reservation status, pricing, guest information, cancellation details, and optional property-specific data.**

## Retrieve accommodation order details

Use this endpoint to retrieve one or more accommodation orders by **order ID** or **reservation ID**.

Provide one of the following:

- `orders` – Retrieve details for up to 100 order IDs.
- `reservations` – Retrieve details for up to 100 reservation IDs.


You can also customise the response using optional parameters:

| Parameter | Description |
|  --- | --- |
| `currency` | Returns monetary amounts in the requested currency where supported. |
| `extras` | Includes additional information such as `accommodation_details`, `policies`, or `extra_charges`. |
| `language` | Returns translated content where available. If omitted, `en-gb` is used by default. |


The `language` parameter only affects supported translated fields and does not localise the entire response.

### Extras

Use the `extras` parameter to enrich the response with additional information.

- `accommodation_details` – Includes property contact details such as name, address, telephone number, email address, and geographic coordinates.
- `policies` – Includes product-level cancellation policies, meal plans, and smoking preferences.
- `extra_charges` – Extends the `price` object with `base`, `display`, `charges`, and `total` for a detailed taxes and fees breakdown.


### Example request

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

## Response

The response returns a `data` array containing one object for each accommodation order.

Common fields include:

| field | Description |
|  --- | --- |
| `id` | Order identifier. |
| `reservation` | Reservation identifier. |
| `status` | Current booking status. |
| `checkin` / `checkout` | Stay dates. |
| `price` | Total and commissionable amounts for the order. |
| `commission` | Estimated or actual commission information. |
| `pin_code` | Traveller verification code used for customer support. |
| `label` | Label provided when the order was created, useful for attribution and reporting. |
| `inventory` | Indicates the inventory type (for example, sell or third-party inventory). |
| `currency` | Accommodation and booker currencies associated with the order. |
| `cancellation_details` | Cancellation timestamp, fee, and original total price when applicable. |
| `accommodation_order_references` | Additional references generated by the accommodation. |
| `remarks` | Traveller remarks captured during booking. |
| `stay_probability` | 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. **This field may not always be returned**. |
| `products` | Product-level reservation details. |


For eligible properties, `key_collection_information` may also be returned with check-in instructions, including key location, collection method, and additional guidance.

### Product-level information

Each item in `products` contains information specific to an individual room or booked product, including:

- `allocation` – Number of guests, adults, and children.
- `guests` – Guest names and email addresses when available.
- `room` and `room_details` – Room identifiers and names.
- `room_reservation` – Room-level reservation identifier.
- `status` – Product status.
- `price` – Pricing details for the product.
- `policies` – Cancellation policy, meal plan, and smoking preference when `extras=policies` is requested.
Cancellation policies are returned **per product rather than per order**, allowing different rooms within the same booking to have different cancellation conditions
See the [cancellation policies section](/demand/docs/orders-api/cancellation-policies) for more details.


### Example response

```json
{
"request_id": "01fr9ez700exycb98w90w5r9sh",
"data": [
  {
    "id": "509430129718799",
    "accommodation": 123456,
    "accommodation_details": {
      "email": "test_hotel@booking.com",
      "location": {
        "address": "111 Street Road",
        "city": 20089219,
        "coordinates": {
          "latitude": 11.923274,
          "longitude": -92.716188
        },
        "country": "US",
        "post_code": "NY 1234"
      },
      "name": "Test Booking Hotel USA",
      "telephone": "+19876543210"
    },
    "cancellation_details": {
      "at": "2025-11-09T00:00:00+00:00",
      "fee": {
        "accommodation_currency": 170.01,
        "booker_currency": 186.87
      }
    },
    "checkin": "2025-11-10",
    "checkout": "2025-11-10",
    "commission": {...},
    "pin_code": "1234",
    "price": {...},
    "products": [...],
    "status": "booked"
  }
]
}
```

## Multi-room status precedence

For bookings containing multiple rooms, each product has its own status.

If products within the same order have different statuses, the overall order status follows predefined precedence rules. For example, `stayed` takes precedence over other statuses when determining the order-level status.

The status is displayed at both the accommodation and product levels in the response.

## Personally Identifiable Information (PII)

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

- Guest `name`
- Guest `email`
- `booker.external_account`, which can be used to associate bookings with your own traveller accounts for loyalty programmes or rewards.


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

If these fields 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.