reservationssummary (B.XML)¶
Use the xml/reservationssummary
endpoint to retrieve all of a property's reservations with check-out dates in the future. This summary only includes information that is essential for matching future modifications/cancellations of existing reservations. No guest details included, other than the guest's name.
URL¶
POST https://secure-supply-xml.booking.com/hotels/xml/reservationssummary
Sample request¶
This request retrieves all reservations for property 375680
.
<request>
<hotel_id>375680</hotel_id>
</request>
Request body¶
Field | Description | Type | Required | Notes |
---|---|---|---|---|
request |
Root element. | object | Required | - |
hotel_id |
The Booking.com property ID for which you want to retrieve reservations. | string | Required | Max. occurrences: 1. |
Sample response¶
A successful response looks like this:
<reservations>
<reservation>
<customer>
<first_name>test</first_name>
<last_name>test</last_name>
</customer>
<date>2015-03-29</date>
<id>325070178</id>
<room>
<arrival_date>2015-02-20</arrival_date>
<currencycode>INR</currencycode>
<departure_date>2015-02-22</departure_date>
<id>37568001</id>
<meal_plan>Breakfast costs INR 15.00 per person per
night.</meal_plan>
<numberofguests>7</numberofguests>
<price date="2015-02-20" rate_id="1354450">350</price>
<price date="2015-02-21" rate_id="1354450">350</price>
<roomreservation_id>1799964999</roomreservation_id>
<totalprice>700</totalprice>
</room>
<time>20:51:09</time>
</reservation>
<reservation>
<customer>
<first_name>test</first_name>
<last_name>test</last_name>
</customer>
<date>2015-03-29</date>
<id>438151297</id>
<room>
<arrival_date>2015-02-20</arrival_date>
<currencycode>INR</currencycode>
<departure_date>2015-02-21</departure_date>
<id>37568001</id>
<meal_plan>Breakfast costs INR 15.00 per person per night.</meal_plan>
<numberofguests>7</numberofguests>
<price date="2015-02-20" rate_id="1354450">350</price>
<roomreservation_id>1799964999</roomreservation_id>
<totalprice>350</totalprice>
</room>
<time>20:51:09</time>
</reservation>
</reservations>
<!-- RUID: [XXXXXXXXXXXXXXXXXXXXX==] -->
Response body¶
Field | Description | Type | Notes |
---|---|---|---|
reservations |
- | array of reservation |
- |
reservation |
- | object | - |
customer |
- | object | - |
first_name |
Guest's first/given name. | string | - |
last_name |
Guest's last/family name. | string | - |
date |
The date the reservation was made. | date | Format: YYYY-MM-DD |
time |
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 |
- | object | - |
arrival_date |
Planned check-in date. | date | Format: YYYY-MM-DD |
currencycode |
The currency used to pay for the reservation. | enum | Use /xml/currencies to retrieve a list of currency codes. |
departure_date |
Planned check-out date. | date | Format: YYYY-MM-DD |
meal_plan |
The meal plan description as it appears on Booking.com. | string | See also Meal Plan Types. |
numberofguests |
The number of persons in the reservation. | integer | - |
price |
The price per day for the reservation. | integer | Currency is specified in currencycode . |
price[@date] |
The date on which the reservation was paid for. | date | Format: YYYY-MM-DD |
price[@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 . |