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.

Use /orders/details/accommodations endpoint 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:

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.

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

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

For orders using third-party inventory rates:

• inventory.third_party is true.
• inventory.type indicates the sort of applicable rate.
• third_party_inventory may contain third-party-specific information.
• checkin_number — The most accurate check-in number currently available for the reservation. It is returned only for TPI reservations and may change when the TPI supplier updates the booking.

Retrieve /orders/details/accommodations again two days before check-in and use the latest returned value during the traveller’s check-in process.

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.

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.

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

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.

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

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

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.

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

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