Errors your OTA returns to Cloudbeds
When responding to requests sent by Cloudbeds (ARIUpdate, GetBookingList,
GetBookingId, ...), you can respond with error IDs listed in our
error code list. Please
use the numeric codes in the ID column. Only errors whose code starts with
FAULT.OTA. are supported.
Errors Cloudbeds returns to your OTA (callbacks)
The list above only applies to responses your OTA sends to Cloudbeds. When
your OTA calls a Cloudbeds callback endpoint (BookingCreate,
CheckAvailability, NotifyBooking, ARIFullRefresh, GetARI), an error
response has Success: false, one of the ErrorCode values below, and a
human-readable Error message with details.
| ErrorCode | Meaning | Returned by |
|---|---|---|
| 1001 | ota_property_id / ota_property_sub_id could not be resolved to a property. When BookingCreate identifies the property this way, a connection still waiting to be activated is not resolvable either and answers 1001 too; one that exists but cannot take bookings answers 1031 or 1034 instead | all callbacks |
| 1010 | No ota_property_id or mya_property_id received | BookingCreate, NotifyBooking |
| 1011 | A required parameter is missing (e.g. booking_json, booking_id), or the data was sent in the query string instead of the POST body | BookingCreate, NotifyBooking, GetARI |
| 1012 | output must be json, pixel or plain | NotifyBooking |
| 1022 | booking_json (or the request body) is not valid JSON | BookingCreate, GetARI |
| 1030 | mya_property_id is not a valid property | BookingCreate, ARIFullRefresh |
| 1031 | Your channel is not enabled for the property. From BookingCreate this means the property has no working connection to your channel — never set up, or set up but not yet activated — so wait for the property to finish before you send bookings | BookingCreate, ARIFullRefresh |
| 1032 | The booking contains credit/debit card data but your channel is not enabled for card handling (see BookingCreate) | BookingCreate |
| 1033 | multipart/form-data is not supported on the secure (card data) endpoint | BookingCreate |
| 1034 | Your channel is set up for the property but the connection is switched off, so the booking was not accepted. Bookings are accepted again once the property re-enables it | BookingCreate |
| 1102 | The resolved properties have conflicting channel currencies, or the same ota_room_id is mapped in more than one resolved property | GetARI |
| 1187 | A required field is missing, or a date field is not an ISO 8601 date | CheckAvailability, GetARI |
| 1188 | A field has an invalid value (e.g. unit_type, number_of_units) | CheckAvailability, GetARI |
| 3454 | The booking failed validation; the Error message contains details | BookingCreate |
| 3901 | One of mya_property_id, ota_property_id or ota_property_sub_id is required | ARIFullRefresh |
| 9200 | No shared_secret parameter received | BookingCreate, CheckAvailability, ARIFullRefresh, GetARI (NotifyBooking tolerates a missing shared_secret for backward compatibility) |
| 9201 | shared_secret does not match | all callbacks |