Activities API ERRORS

Errors are classified in two categories:

  • Communication errors: Standard HTTP error codes are used.
  • Application errors: Specific codes and descriptions can be returned in a list of errors

Communication errors

API ERRORS

HTTP status code

Description

200

OK - The request has succeeded. The client can read the result of the request in the body and the headers of the response.

400

Bad Request - The request could not be understood by the server due to malformed syntax. The message body will contain more information

403

Forbidden - The server understood the request, but is refusing to fulfill it

Developer Over Qps - You have exceeded your API quota

Please check the response body or the response header "X-Mashery-Error-Code" to be sure which error you are having (Forbidden or Developer Over Qps)

404

Not Found - The requested resource could not be found. This error can be due to a temporary or permanent condition

406

Not Acceptable: The resource identified by the request is only capable of generating response entities which have content characteristics not acceptable according to the accept headers sent in the request.

415

Unsupported Media Type - Use the Content-Type header to set application/json or application/xml based on the format of your payload

500

Internal Server Error. You should never receive this error, please report it to us through XML Support ticket.

502

Bad Gateway - The server was acting as a gateway or proxy and received an invalid response from the upstream server.

503

Service Unavailable - The server is currently unable to handle the request due to a temporary condition which will be alleviated after some delay. You can choose to resend the request again.

596

Service Not Found - an invalid endpoint has being reached. Please check that the endpoint you are using to send the petitions is correct.

Application errors:

Error code or category

Error message

GENERAL

 

E_REQUEST_INVALID

The received request is not a valid JSON or XML.

E_REQUEST_UNRECOGNIZEDFIELD

The following field is not recognized: %s.

E_REQUEST_MISSINGFIELD

The following required field is missing: %s.

E_REQUEST_UNKNOWNFILTER

Unknown filter type, allowed filters are: %s

E_REQUEST_MISSINGFILTERVALUE

Missing '%s' for filter type: %s

E_REQUEST_FILTERNUMERICVALUE

Value for filter type %s must be numeric

E_REQUEST_MULTIPLEFILTERNOTALLOWED

Filtering by %s can only be used once per combined criteria

E_REQUEST_FILTERCOMBINATIONNOTALLOWED

Filtering by %s and %s cannot be combined at the same criteria

E_REQUEST_TOOLONGFIELD

The following field exceeds the maximum length allowed (max: %s, received: %s): %s

E_REQUEST_INVALIDLANGUAGE

The requested language (%s) is not valid.

E_REQUEST_INVALIDCARDTYPE

The requested card type (%s) is not valid.

E_REQUEST_INVALIDPAGE

The requested page is not valid.

E_REQUEST_TOOMANYRESULTS

Too many results (%s) requested, maximum allowed is %s.

E_REQUEST_RANGEEXCEEDED

The maximumn days range allowed is %s (%s requested).

E_REQUEST_DATERANGE

The requested date range is not valid.

E_REQUEST_PASTDATE

The requested date is in the past.

E_REQUEST_NOTINRANGEFIELD

The following field are not in the allowed range (max: %s, min: %s, received: %s): %s

E_REQUEST_INVALIDREFERENCEFORMAT

The reference format is invalid: %s

E_REQUEST_ATLEASTONEADULT

At least one adult is needed

E_REQUEST_DETAILSCONTRACT

The request with a contract is not allowed

Authentication errors

E_ERROR_AUTH

Authorization token could not be validated.

E_INVALID_CLIENT

Client is not properly configured for the requested operation. Please contact the service provider.

Detail api call specific errors

E_ACTIVITYDETAIL_NOTFOUND

No activity details could be found for the given data.

Booking confirmation errors

E_CONFIRMATION_DUPLICATEDSERVICES

Duplicated purchaseableServiceIds in the booking confirmation request.

E_CONFIRMATION_UNKNOWNSERVICE

The system was unable to retrieve purchaseable services with the following IDs: %s

E_CONFIRMATION_WRONGLANGUAGE

All purchaseableServiceId to confirm must have been generated using the same language.

E_CONFIRMATION_WRONGOFFICE

All services to confirm must belong to the same office.

E_CONFIRMATION_WRONGCOMPANY

All services to confirm must belong to the same company.

E_CONFIRMATION_MISSINGQUESTION

Required question with code %s (service %s) was not answered.

E_CONFIRMATION_MISSINGPAXINFORMATION

Required information with code %s (service %s) was not filled for all paxes.

E_CONFIRMATION_PAXESDONOTMATCH

Ages specified at confirm do not match the ones specified during details request.

E_CONFIRMATION_SERVICENOLONGERAVAILABLE

The purchaseable service %s is no longer availavle. Please, do a new detail.

E_CONFIRMATION_SERVICENOTCONFIRMED

There was an error confirming the puchaseable service %s.

E_CONFIRMATION_NOTRESPONDING

The system is not responding and the booking was not confirmed. Please, try again.

E_CONFIRMATION_PAYMENTERROR

There was an error while processing the payment. The booking was not confirmed.

E_CONFIRMATION_GATEWAYNOTRESPONDING

The payment gateway is not responding and the booking was not confirmed. Please, try again.

E_CONFIRMATION_CARDNUMBERINNAME

For security reasons the holder name cannot contain the card number.

E_CONFIRMATION_INVALIDCARD

The provided card information is not valid.

E_CONFIRMATION_INVALIDEXPIRATIONMONTH

The provided expiration month is not valid. Valid values are from 1 to 12.

E_CONFIRMATION_INVALIDEXPIRATIONYEAR

The provided expiration year is not valid. Valid values are from %s

E_CONFIRMATION_PASTEXPIRATIONDATE

The provided expiration date must be greater than current date

E_CONFIRMATION_LIMITEXCEEDED

The credit card has not enough funds to pay the booking.

E_CONFIRMATION_ATLASSIMULATEPRECONFIRMERROR

Error during preconfirm the booking (simulation): %s

E_CONFIRMATION_ATLASCOMMITPRECONFIRMERROR

Error during preconfirm the booking (commit): %s

E_CONFIRMATION_ATLASSIMULATECONFIRMERROR

Error during confirm the booking (simulation): %s

E_CONFIRMATION_ATLASCOMMITCONFIRMERROR

Error during confirm the booking (commit): %s

E_CONFIRMATION_ATLASRECONFIRMERROR

Error during reconfirming the booking %s-%s: %s

E_CONFIRMATION_ATLASCANCELPRECONFIRMBOOKINGERROR

Error during cancelling the preconfirmed booking %s-%s: %s

E_CONFIRMATION_PURCHASEABLESERVICEALREADYCONFIRMED

The purchaseable service %s has already been confirmed. Cant't be confirmed twice.

E_CONFIRMATION_RETRIEVEPICKUPSID

The confirmation request contains a retrievePickupId instead of a purchaseableServiceId. Please, use the retrievePickupId %s to obtain a valid purchaseableServiceId and use it in the confirmation operation

Booking detail errors

E_BOOKING_NOTFOUND

No booking was found for reference %s.

E_BOOKING_GETBOOKINGERROR

The booking %S can't be retrieved form DB.

Booking cancellation errors

E_BOOKING_NOTCANCELLABLE

Booking with reference %s cannot be cancelled.

E_BOOKING_CANCELLATIONERROR

Error trying to cancel booking with reference %s: %s - %s

E_BOOKING_REFUNDERROR

Error trying to refund booking with reference %s: %s - %s

E_BOOKING_GETBOOKINGCANCELERROR

Error trying to cancel booking with reference %s. The booking can't be retrieved form DB.

Other errors

E_AVAILABILITY

An unexpected error has occured during availability, please try again.

E_UNKNOWN

Unknown error.

Retrieve pickups specific errors

E_RETRIEVEPICKUPS_UNKNOWNSERVICE

The system was unable to retrieve pickups for the following service ID: %s

E_RETRIEVEPICKUPS_NOTFOUND

The system was unable to find pickups for the following service ID: %s

E_RETRIEVEPICKUPS_ERROR

The system was unable to retrieve pickups for the following service ID: %s

E_RETRIEVEPICKUPSHOTELNOTINFORMED_ERROR

The hotel code (TTI, GIATA or Hotelbeds code) must be specified

E_RETRIEVEPICKUPSTTIHOTELNOTRESOLVED_ERROR

The TTI code %s can't be resolved as a valid hotel

E_RETRIEVEPICKUPSGIATAHOTELNOTRESOLVED_ERROR

The GIATA code %s can't be resolved as a valid hotel

Docs Navigation