Invalid booking id / reservation number. Only numbers are allowed
bookingId must be numeric
1101
400
The provided key has already been used previously
BookingHold: rateKey reused — get fresh one
1101
500
The provided key has already been used previously.
BookingNew: bookingKey already used. Do not obtain a new key to restart the flow — see BookingNew
1201
500
The itinerary does not contain valid services
Booking corrupt — escalate
1202
500
Locator’s not found for the requested channel
Booking not visible from this channel
3003
500
Cannot get a valid response from the cancellation service
Supplier failure — escalate
3005
500
Cancellation timeout
Retry after 1-2 min, verify with BookingGet
4001
400
Invalid Hold Request, can not parse the rateKey
rateKey corrupted or mis-encoded
4002
400
You cannot invoke ‘Hold’ without first performing a ‘CheckRates’
Use rateKey from CheckRates, not Rates
4003
400
Hold rateKey older than 20 min
Repeat CheckRates
4008
400
The requested rate is no longer available.
Not defined. The response does not state the reason. Observed in one response. The Hold request was sent less than 20 seconds after a successful CheckRates. 4008 and 4009 return the same message; the difference between them is not defined. Request a new rateKey by repeating Rates and CheckRates. Do not use the code to tell the cause apart.
4009
400
The requested rate is no longer available.
Not defined. The response does not state the reason. Observed in one response. The Hold request was sent less than 20 seconds after a successful CheckRates. 4008 and 4009 return the same message; the difference between them is not defined. Request a new rateKey by repeating Rates and CheckRates. Do not use the code to tell the cause apart.
5001
500
Invalid Policy
Internal — escalate
6001
400
Invalid New Request, can not parse the BookingKey
bookingKey corrupted/expired
6002
400
You cannot use the 'New' operation if more than 20 minutes have passed since obtaining the BookingKey from 'Hold'.
Not defined. BookingNew returned this code with this message; the condition that triggers it is not defined. Obtain a new bookingKey with BookingHold. Do not use the code or the number in the message to tell the cause apart.
6102
400
Invalid range, only 31 days are allowed
BookingReservations returned this code with this message. The message states that the range is not valid and gives a number of allowed days; how the days are counted is not defined. Reduce the range, or split the period into several requests.
The same numeric code can mean different things depending on the operation that returned it, so the code alone is not enough to branch on — read it together with the endpoint you called. The table below covers only the variants verified against captures; it is not the full list of places these codes appear in the API. For the token variant of 1003 the response does not distinguish between a wrong id, a wrong secret and inactive credentials — see Authentication.
Code
Operation
HTTP
Meaning in that context
1003
Token
400
invalid_client, with no eventId and no message — the response does not say which credential check failed
1003
HotelRates
401
The channel id <X> is not enabled to be used in <env> — returned by the call made after the token, not by the token
1101
BookingNew
500
The provided key has already been used previously. — the bookingKey was already used by a previous BookingNew. Do not obtain a new key to restart the flow; see BookingNew
1203
BookingDelete
400
Your reservation is currently being created. Please wait a moment before accessing it.