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.

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:

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.

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

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

Common fields include:

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

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.

  Did you know?

  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 for more details.

{
"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"
  }
]
}

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.

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.

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

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