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 | 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 | 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 |
| 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 |