In beta

This API endpoint is currently in a beta phase. You should direct any questions during the Beta phase to your Booking.com contact person via the appropriate channels.

Managing missed reservations

This section describes all the possible actions related to the Missed reservations API.

Retrieving missed reservations

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

The GET /reservations-flow-control/missed-reservations request enables you to retrieve missed reservations for all your properties.

Use cases

You can use this endpoint to retrieve missed reservations in two ways, depending on your use case. However, you must either include the check_in_start and check_in_end parameters, or the from and until parameters:

  • To search by time range (for example, the duration of an outage), you must use from and until.
  • To search by check-in date to handle reservations of immediate concern, you must use check_in_start and check_in_end.

Query parameters

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

Element Description Type Required/Optional Notes
check_in_start Specifies the beginning of the check-in date range. string optional You can use this element to search by check-in date range. Follows YYYY-MM-DD.
check_in_end Specifies the end of the check-in date range. string optional You can use this element to search by check-in date range. Follows YYYY-MM-DD.
from Specifies the beginning of a time range. string optional You can use this to search by time range. Refers to the deadline time when the data was "missed." Follows YYYY-MM-DDThh:mm:ss.mmmZ.
until Specifies the end of a time range. string optional You can use this to search by time range. Refers to the deadline time when the data was "missed." Follows YYYY-MM-DDThh:mm:ss.mmmZ.
property_id Specifies the id(s) of the property or properties you want to retrieve missed reservations for. array of integers optional
limit Specifies the maximum amount of missed reservations you want to retrieve. integer optional
page_size Specifies the amount of missed reservations you want to retrieve per page. integer optional Default: 50
reference_type Specifies the reservation type you want to retrieve . string optional Possible values are confirmation, modification, and cancellation.
reservation_id Specifies the reservation id(s) you want to retrieve. array of integers optional

Response body example

The following is a successful response body example:

{
    "meta": {
        "ruid": "UmFuZG9tSVYkc2RlIyh9YRXJVNGNM1xbxtwnkx4JfLwqoVPj5OwWtLL9q85pKPTygsQdDURy+bKKasj8aIE0NywVyfhzO//gz+7SN3iJ3fvtl42zpRAM07lJkM5eGptxRJuG37Hnw2E=",
        "next_page": "https://supply-xml.booking.com/reservations-flow-control/missed-reservations?from=2021-02-28T00%3A00%3A00Z&until=2021-03-01T00%3A00%3A00Z&cursor=UkoAAAB5AAAAAukR2OW61c_uJ9bquslb7jw6OxsHqLDPUihBfY70-YKXTl_zrFXhaiIT8jGeqsmdsGY3ReGvm0QWpaUBw-o4GT0qpg"
    },
    "errors": [],
    "data": [
        {
            "reference_timestamp": "2021-02-28T00:00:51Z",
            "uri": "https://secure-supply-xml.booking.com/hotels/ota/OTA_HotelResModifyNotif?id=3307795069&hotel_id=283442",
            "hotel_id": 283442,
            "reservation_id": 3307795069,
            "reason": "Invalid Credit Card Number",
            "failure_type": "refused",
            "checkin": "2021-02-28",
            "reference_type": "cancellation"
        },
        {
            "reference_type": "cancellation",
            "checkin": "2021-02-27",
            "reason": "Reservation not found",
            "failure_type": "refused",
            "reservation_id": 2642335616,
            "hotel_id": 29889,
            "uri": "https://secure-supply-xml.booking.com/hotels/ota/OTA_HotelResModifyNotif?id=2642335616&hotel_id=29889",
            "reference_timestamp": "2021-02-28T00:07:09Z"
        },
        {
            "checkin": "2021-03-05",
            "reference_type": "cancellation",
            "reservation_id": 3154229230,
            "hotel_id": 78173,
            "failure_type": "missed_reservation",
            "reason": null,
            "reference_timestamp": "2021-02-28T00:10:30Z",
            "uri": "https://secure-supply-xml.booking.com/hotels/ota/OTA_HotelResModifyNotif?id=3154229230&hotel_id=78173"
        }
    ],
    "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
> failure_type Specifies the type of failure. enum Possible values are missed_deadline, missed_reservation, refused, or missed_confirmation.
> hotel_id Specifies the id of the property. integer
> reason Specifies the reason for the missed reservation. string You can find a reason when failure_type is refused.
> reference_timestamp Specifies the time when the reservation reference was sent. string Follows YYYY-MM-DDThh:mm:ss.mmmZ.
> reference_type Specifies the reservation type you retrieved. string
> reservation_id Specifies the id of the reservation. integer
> uri Specifies the link to the full reservation object. string
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 send this id to Booking.com customer support if you run into an issue. This can help to understand what went wrong.
warnings Contains potential warnings. These can help you improve your requests. array
errors Contains potential errors. These can help you understand what went wrong with your request. array