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.

Reservations Recovery API overview

Use the Reservations Recovery API to recover missed reservations.

What are missed reservations?

Missed reservations are those messages (including confirmations, modifications, and cancellations) that were not:

  • Pulled within 30 minutes (using the B.XML endpoint). For example, you did not retrieve the reservations within the timeout period.
  • Pulled and acknowledged within the 30-minute timeout period (using the OTA XML endpoints). For example, you did not acknowledge a reservation by calling the POST OTA_HotelResNotifRS endpoint within the timeout period.

Active rejections are currently not supported

Reservation messages that were actively rejected using the POST OTA_HotelResNotifRS endpoint with an <Error> tag response are currently not returned using the missed-reservations endpoint.

You must use this API along with the Reservations API (both OTA XML and B.XML endpoints). The following sections explain when to use this API and provide more information on the reservation recovery process.

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.

If you do not enable the feature, the property will still receive fallback emails for reservations missed after the 30-minute timeout period.

If reservations messages whose checkin date is within the next 48 hours are not pulled/acknowledged in time, then the fallback email is triggered immediately after the 30-minute timeout period irrespective of the feature setting.

Why use the Reservations Recovery API?

To manage missed reservations without implementing this API, you must either:

  • Go to the Connectivity Portal and select Reports > Email Fallbacks.
  • Read the fallback emails that Booking.com sends you.

Both of these options require manual effort and are not scalable. However, the Reservations Recovery API enables you to process the missed reservations data with better performance, and more up-to-date and accurate data. This in turn enables you to improve your recovery and set up better follow-ups with your properties.

Reservations Recovery API process

This section illustrates the reservations recovery process flow when using both OTA XML and B.XML Reservations API endpoints.

OTA reservations recovery process

The following 2 process flow diagrams show the steps to recover missed reservations that are new, modified, or cancelled.

Click on the diagram to see it in full screen. To return to the topic, click the browser's back button.

Retrieve missed reservations Retrieve missed reservations
1. Provider fails to acknowledge a new reservation within the first 30-minute window by calling the POST OTA_HotelResNotif endpoint.
2. Booking.com moves the missed reservations to the missed reservations queue.
3. Provider calls the GET /reservations-flow-control/missed-reservations endpoint after the 30-minute timeout period but within the 24-hour deadline.
4. Booking.com returns reservation ID(s) of any missed reservations with reference_type=confirmation_to_hotel.
5. Provider calls the GET OTA_HotelResNotif endpoint with the specific reservation ID and property ID.
6. Provider integrates booking into their system and updates inventory.
7. Provider calls the POST OTA_HotelResNotif endpoint within the timeout period.
8. Booking.com returns a successful OTA_HotelResNotifRS message.
Note: If the provider doesn't retrieve the missed reservation messages and acknowledge the reservations within the 24-hour timeout window, then Booking.com sends a fallback email directly to the property with the reservation details.
1. Provider fails to acknowledge a modified/cancelled reservation within the first 30-minute window by calling the POST OTA_HotelResModifyNotif endpoint.
2. Booking.com moves the missed reservations to the missed reservations queue.
3. Provider calls the GET /reservations-flow-control/missed-reservations endpoint after the 30-minute timeout period but before the 24-hour deadline.
4. Booking.com returns reservation ID(s) of any missed reservations with reference_type=modification_to_hotel or cancellation_to_hotel.
5. Provider calls the GET OTA_HotelResModifyNotif endpoint with the specific reservation ID and property ID.
6. Provider integrates booking into their system and updates inventory.
7. Provider calls the POST OTA_HotelResModifyNotif endpoint within the timeout period.
8. Booking.com returns a successful OTA_HotelResModifyNotifRS message.
Note: If the provider doesn't retrieve the missed reservation messages and acknowledge the reservations within the 24-hour timeout window, then Booking.com sends a fallback email directly to the property with the reservation details.

B.XML reservations recovery process

Retrieve missed reservations
1. Provider fails to retrieve a new reservation within the first 30-minute window by calling the POST reservations endpoint.
2. Booking.com moves the missed reservations to the missed reservations queue.
3. Provider calls the GET /reservations-flow-control/missed-reservations endpoint after the 30-minute timeout period but within the 24-hour deadline.
3. Booking.com returns reservation ID(s) of any missed reservations.
4. Provider calls the POST reservations endpoint with the specific reservation ID and property ID.
5. Booking.com returns the reservations details.
6. Provider integrates booking into their system and updates inventory.
7. After a delay, call the /reservations endpoint again.
Note: If the provider doesn't retrieve the missed reservation messages within the 24-hour timeout window, then Booking.com sends a fallback email directly to the property with the reservation details.

Quick Actions

→ To retrieve missed reservations, see Retrieving missed reservations