Retrieving reservations summary

Use the reservationssummary endpoint to retrieve both the old and new reservations of a property with check-in 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/reservationssummary

Use 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>
    <last_change>2022-04-21 00:00:00</last_change>
    <limit>200</limit>
</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.