Retrieving reservations summary¶
Use the reservationssummary endpoint to retrieve both the old and new reservations of a property with check-out dates in the future. Use this endpoint to match modifications/cancellations of future-dated reservations.
The API only provides summary information and doesn't include guest details, other than the guest's name.
Retrieving all unstayed reservations¶
POST https://secure-supply-xml.booking.com/hotels/xml/reservationssummaryUse this endpoint to get all the recent property reservations made through the Booking.com channels. You can apply a filter to retrieve reservations specific to certain properties specified by a property ID.
Query parameters¶
The following table describes the optional elements you can add as query parameters to filter the incoming reservations:
| Element | Description | Type | Required/Optional | Notes |
|---|---|---|---|---|
request |
Root element. | object | Required | - |
hotel_id |
Specify the unique property ID to identify the property you are trying to retrieve reservations for. | integer | Required | Max. occurrences: 1. |
Query parameter example¶
The following query retrieves reservation(s) for a property with ID 8011855.
<request>
<hotel_id>8011855</hotel_id>
</request>Response body example¶
The following is a successful response body example:
<reservations>
<reservation>
<customer>
<first_name>Alice</first_name>
<last_name>Gordon</last_name>
</customer>
<date>2022-05-12</date>
<id>3820212523</id>
<room>
<arrival_date>2022-05-15</arrival_date>
<currencycode>EUR</currencycode>
<departure_date>2022-05-17</departure_date>
<id>801185502</id>
<meal_plan>Breakfast is included in the room rate.</meal_plan>
<numberofguests>2</numberofguests>
<price date="2022-05-15" rate_id="25279855">60.50</price>
<price date="2022-05-16" rate_id="25279855">60.50</price>
<roomreservation_id>3641632086</roomreservation_id>
<totalprice>121</totalprice>
</room>
<room>
<arrival_date>2022-05-15</arrival_date>
<currencycode>EUR</currencycode>
<departure_date>2022-05-17</departure_date>
<id>801185502</id>
<meal_plan>Breakfast is included in the room rate.</meal_plan>
<numberofguests>2</numberofguests>
<price date="2022-05-15" rate_id="25279855">60.50</price>
<price date="2022-05-16" rate_id="25279855">60.50</price>
<roomreservation_id>3641632104</roomreservation_id>
<totalprice>121</totalprice>
</room>
<room>
<arrival_date>2022-05-15</arrival_date>
<currencycode>EUR</currencycode>
<departure_date>2022-05-17</departure_date>
<id>801185502</id>
<meal_plan>Breakfast is included in the room rate.</meal_plan>
<numberofguests>2</numberofguests>
<price date="2022-05-15" rate_id="25279855">60.50</price>
<price date="2022-05-16" rate_id="25279855">60.50</price>
<roomreservation_id>3641632124</roomreservation_id>
<totalprice>121</totalprice>
</room>
<room>
<arrival_date>2022-05-15</arrival_date>
<currencycode>EUR</currencycode>
<departure_date>2022-05-17</departure_date>
<id>801185502</id>
<meal_plan>Breakfast is included in the room rate.</meal_plan>
<numberofguests>2</numberofguests>
<price date="2022-05-15" rate_id="25279855">60.50</price>
<price date="2022-05-16" rate_id="25279855">60.50</price>
<roomreservation_id>3641632137</roomreservation_id>
<totalprice>121</totalprice>
</room>
<room>
<arrival_date>2022-05-15</arrival_date>
<currencycode>EUR</currencycode>
<departure_date>2022-05-17</departure_date>
<id>801185502</id>
<meal_plan>Breakfast is included in the room rate.</meal_plan>
<numberofguests>2</numberofguests>
<price date="2022-05-15" rate_id="25279855">55</price>
<price date="2022-05-16" rate_id="25279855">55</price>
<roomreservation_id>3641632153</roomreservation_id>
<totalprice>110</totalprice>
</room>
<time>17:09:47</time>
</reservation>
</reservations>
<!-- RUID: [UmFuZG9tSVYkc2RlIyh9YVTaHvwstRic8Jl/BnXmLd9XUKM5o7PNTJVwBAolZyAvcGw2v3YnldZcTTwBgpaRw+CXxMviSsbKj2UbI//TrEQ=] --Response body elements¶
The following table describes the response elements:
| Element | Attribute | Description | Type | Notes |
|---|---|---|---|---|
reservations |
Root element | array of reservation |
||
> reservation |
Contains reservation details for each reservation. | object | ||
>> customer |
Contains customer information. | object | ||
>>> first_name |
Specifies the guest's first/given name. | string | ||
>>> last_name |
Specifies the guest's last/family name. | string | ||
>> date |
Specifies the date the reservation was made. | date | Format: YYYY-MM-DD |
|
>> time |
Specifies the time the reservation was made. | time | Format: HH:MM:SS (CET in winter, CEST in summer.) |
|
>> id |
The ID of the parent element. | string | Child of both reservation and room. |
|
>> room |
Contains information about the reserved room. | object | ||
>>> arrival_date |
Specifies the planned check-in date. | date | Format: YYYY-MM-DD |
|
>>> currencycode |
Specifies the currency used to pay for the reservation. | enum | Use /xml/currencies to retrieve a list of currency codes. | |
>>> departure_date |
Specifies the planned check-out date. | date | Format: YYYY-MM-DD |
|
>>> meal_plan |
Specifies the meal plan description as it appears on Booking.com. | string | See also Meal Plan Types. | |
>>> numberofguests |
Specifies the number of persons in the reservation. | integer | ||
>>> price |
Specifies the price per day for the reservation. | integer | Currency is specified in currencycode. |
|
date |
The date on which the reservation was paid for. | date | Format: YYYY-MM-DD |
|
rate_id |
The ID of the rate used for the reservation. | string | ||
>>> roomreservation_id |
The ID of the room reservation. | string | A reservation can include multiple rooms, and therefore multiple room reservations. |
|
>>> totalprice |
The total price for the reservation. | integer | Currency is specified in currencycode. |