Beta version

This API endpoint is currently in beta. Make sure to direct any questions during the beta phase to your Booking.com contact person via the appropriate channels.

Retrieving missed reservations¶

Use the GET /reservations-flow-control/missed-reservations endpoint to retrieve missed reservations for all your properties.

When processing reservations using OTA endpoints, after processing the missed reservations in your system, make sure to send an acknowledgement for those reservations so that Booking.com's records are updated as well:

To acknowledge missed confirmation messages, see Acknowledging new reservations.
To acknowledge missed modification or cancellation messages, see Acknowledging modified or cancelled reservations.

The feature 'Enable Reservation Recovery API' is enabled by default

When you implement the Reservations Recovery API, the feature: Enable Reservation Recovery API (enable_reservation_recovery_api) is enabled for you. With the feature enabled, the timeout period to trigger the fallback email changes from 30 minutes to 24 hours with the exception of reservations whose check-in date is within the next 48 hours. For such reservations, the fallback email is triggered immediately after the 30-minute timeout period.

URL¶

GET https://supply-xml.booking.com/reservations-flow-control/missed-reservations

Query parameters¶

You can use the following query parameters to further limit your search.

Element	Description	Type	Required/Optional	Notes
`page_size`	Specifies the maximum number of pages you would like to retrieve the missed reservations.	integer	optional	Default: `50`

Query parameter example¶

The following query parameter retrieves missed reservations with page-size: 10.

https://supply-xml.booking.com/reservations-flow-control/missed-reservations?page_size=10

Response body example¶

The following is a successful response body example:

{
    "errors": [],
    "data": [
        {
            "checkin": "2023-12-23",
            "reference_type": "confirmation_to_hotel",
            "hotel_id": 0011125,
            "uri": "https://secure-supply-xml.booking.com?id=&hotel_id=0011125",
            "reservation_status": "active",
            "reservation_id": 0016986201
        }
    ],
    "meta": {
        "ruid": "moUFs252tSVYkc2RlIyh9YTK3FrpKPY1szkzuWJLO536JCpJFDCgMsNdofFUAxtIEQ0svkvkxwbsz5ypzLK4fP4vD9Fr81Q2WNvhsAjZFYR7IzVjfKV2UzeJzdey2632",
        "next_page": "https://supply-xml.booking.com/reservations-flow-control/missed-reservations?page_size=10&cursor=dpt2ts9wQVLR3KCdWyoXCqwhfU37eCC9N_CcSyKFr0e34tBEbz55wzkeIO3AeyBgH3UEo8DT4jZW3JbcIRSfUYdXMZ3k0baf0KjHLsE\"
    },
    "warnings": []
}

Response body elements¶

The following table describes the response elements:

Element	Description	Type	Notes
`data`	Contains the response object.	object
> `checkin`	Specifies the check-in date.	string
> `reference_type`	Specifies the reservation type you retrieved.	string
> `hotel_id`	Specifies the property ID.	integer
> `uri`	Specifies the link to the full reservation object.	string	This link refers to the OTA endpoint of the Reservations API.
> `reservations_status`	Specifies a status from a list of reservation status.	enumerated string	Can contain the following values: - `active`: The reservation is open for stay or stayed. - `cancelled`: The reservation was cancelled. - `archived`: The reservation was archived because the checkin date was far back in the past.
> `reservation_id`	Specifies the ID of the reservation.	integer
`meta`	Contains the meta data that comes with the response.	object
> `next_page`	Specifies the URL with the next page of results.	string
> `ruid`	Specifies the unique ID of the request.	string	You can share this ID with the Booking.com Connectivity Support team when you run into an issue. This can help in understanding what went wrong.
`errors`	Contains potential errors. These can help you understand what went wrong with your request.	array
`warnings`	Contains potential warnings. These can help you improve your requests.	array

Quick Actions¶

→ To retrieve new reservations using the OTA solution, see Retrieving new reservations.
→ To acknowledge missed confirmation messages using the OTA solution, see Acknowledging new reservations.

→ To retrieve modified or cancelled reservations using the OTA solution, see Retrieving modified or cancelled reservations.
→ To acknowledge missed modification or cancellation messages using the OTA solution, see Acknowledging modified or cancelled reservations.

→ To process reservations using the B.XML endpoint, see Retrieving reservations using B.XML

Is this page helpful? Yes | No