All API requests may return error responses. The HTTP status code indicates the general category of the error, while the response body contains a standardized error code and a brief description.
Messages are generic for customers to ensure clarity and stability across versions.
HTTP status code
Description
200 OK
The request was succesful - Request successful. The response body and headers contain the requested data.
201 CREATED
The request was succesful - Resource successfully created. The response includes relevant details in the body and headers.
400 BAD REQUEST
BAD_REQUEST_ERROR - The request is invalid. Check the request structure, required fields, and parameter values.
401 UNAUTHORIZED
Not authorized - Invalid or expired authentication token.
403 FORBIDDEN
The request was understood but refused (e.g., account inactive or quota exceeded).
404 NOT FOUND
Not found - The requested resource could not be found.
406 NOT ACCEPTABLE
Not Acceptable - The requested resource cannot generate content in the acceptable formats specified.
409 CONFLICT
The request conflicts with the current state of the resource (e.g., non-cancellable booking).
415 UNSUPPORTED MEDIA TYPE
Unsupported Media Type - The Content-Type header is not supported. Use application/json and ensure payload format is correct.
500 INTERNAL SERVER ERROR
SYSTEM_ERROR - An unexpected error occurred while processing the request. Try again later.
502 BAD GATEWAY
Bad Gateway - Invalid response received from an upstream server.
503 SERVICE UNAVAILABLE
Service Unavailable - The service is temporarily unavailable. Retry after a short delay.
596 SERVICE NOT FOUND
Service Not Found - Invalid endpoint. Verify the endpoint URL.
The following error codes may be returned in the response body.
Code - Description
(400) E_REQUEST_INVALID The request is not a valid JSON or XML.
(400) E_REQUEST_PASTDATE Date is in the past.
(400) E_REQUEST_ATLEASTONEADULT At least one adult (18+) is required.
(400) E_REQUEST_INVALIDTERMINALCODE Invalid terminal code: %s.
(400) E_REQUEST_GPSCOORDINATES Invalid GPS coordinates: %s.
(400) E_REQUEST_ATLASCODE Invalid atlas code: %s.
(400) E_REQUEST_INVALIDDATEFORMAT Invalid date format: %s. Expected: YYYY-MM-DDThh:mm:ss.
(400) E_REQUEST_ADULTSDONTMATCH Number of adults in occupancies does not match number in paxes.
(400) E_REQUEST_CHILDRENDONTMATCH Number of children in occupancies does not match number in paxes.
(400) E_REQUEST_AGESDONTMATCH Number of children/infants does not match provided ages.
(400) E_REQUEST_SAMEFROMTO Pickup and destination locations must differ.
Code - Description
(500) E_CONFIRMATION_DUPLICATEDSERVICES Duplicated services in booking confirmation request.
(500) E_CONFIRMATION_WRONGLANGUAGE All services must be in the same language as availability.
(500) E_CONFIRMATION_WRONGOFFICE All services must belong to the same office.
(500) E_CONFIRMATION_WRONGCOMPANY All services must belong to the same company.
(500) E_CONFIRMATION_PAXESDONOTMATCH Passenger ages at confirmation do not match those in details.
(500) E_CONFIRMATION_SERVICENOTCONFIRMED Error confirming service: %s.
(500) E_CONFIRMATION_NOTRESPONDING System not responding. Booking not confirmed. Retry later.
(500) E_CONFIRMATION_INVALIDRATEKEY Product values have changed. Regenerate availability before confirming.
(400) E_CONFIRMATION_EMPTYTRANSFERS No transfers to confirm.
(400) E_CONFIRMATION_INSUFFICIENTSEATS Not enough capacity for all passengers in %s direction.
(400) E_CONFIRMATION_INVALIDPICKUPDATE Invalid pickup date.
(400) E_CONFIRMATION_INVALIDTRANSFERDATE Invalid transfer date.
(400) E_CONFIRMATION_INVALIDPICKUP Pickup error: %s.
(400) E_CONFIRMATION_INVALIDDROPOFF Dropoff error: %s.
(400) E_CONFIRMATION_RATEKEYHASH Rate key has been altered.
(400) E_CONFIRMATION_RATEKEYCREDENTIALS Invalid rate key credentials.
(500) E_CONFIRMATION_DETAILSNOTEMPTY Transfer details cannot be empty.
(400) E_CONFIRMATION_DETAILDIRECTIONNOTEMPTY Direction for %s should not be empty.
(400) E_CONFIRMATION_DETAILTYPENOTEMPTY Type for %s should not be empty.
(400)E_CONFIRMATION_DETAILCODENOTEMPTY Code for %s should not be empty.
(400)E_CONFIRMATION_TRANSFER_TYPEINVALID Invalid transfer detail value %s for type %s.
(400)E_CONFIRMATION_DETAILDIRECTIONSAMERATEKEY Direction for %s must match for rateKey %s.
Code - Description
(400) E_BOOKING_NOTFOUND No booking found for reference %s.
(500) E_BOOKING_GETBOOKINGERROR Cannot retrieve booking %s.
Code - Description
(409) E_BOOKING_CANCELLATIONERROR Error cancelling booking %s: %s - %s.
