CLcloudbeds
Bookings

GetBookingList

Returns a list of bookings/reservations which have not been previously downloaded or have been modified.

The pull interval can be freely set. For channels that do not support the CreateBooking callback the interval is usually set to pull bookings every 5 minutes. If CreateBooking is supported then the GetBookingList will be used as a fallback every 30 minutes.

The OTA can also send Cloudbeds a NotifyBooking callback to inform about new bookings available to be polled.

post/GetBookingList

Request

  • Base URL
    https://api.your-ota.com/cloudbeds
  • URL
    https://api.your-ota.com/cloudbeds/GetBookingList
  • Auth
    API key in query parameter shared_secret

Request body

mya_property_idinteger required

Property ID on the Cloudbeds channel manager

ota_property_idstring required

Username, login or property ID on the OTA

ota_property_passwordstring required

Password for property on your OTA. In case the OTA does not use passwords this will be an empty string.

ota_property_sub_idstring required

Property ID on the OTA, if OTA supports multiple properties under one ota_property_id/ota_property_password combination. See GetSubProperties for more details.

guidstring required

Request reference ID, used for debugging and support requests.

shared_secretstring required

Authentication between the OTA and the channel. Identical for all requests. Not to be shared with customers.

ota_cidstring required

OTA ID as given by Cloudbeds

verb'GetBookingList' required
ota_booking_versionstring nullable required

With each request we send along ota_booking_version, which has the format YYYY-MM-DD HH:MM:SS and indicates the time in UTC we last successfully requested bookings. It can be null if no successful response has been received so far. Please use ota_booking_version to only return to us new or modified bookings made since then. To ensure that no booking are skipped due to a time-offset between your and our servers make sure to always reduce 5 or more minutes from the time given. Example: we provide 2017-06-22 12:09:19, then please return all new/modified/cancelled bookings since 2017-06-22 12:04:19 (5 minutes before the time sent).

If ota_booking_version is null please return all bookings.

Response

GetBookingList

OR

Changes

No recorded changes to this operation across all 1 revision of this API.