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.