A variety of error messages may be returned by the API, details on some of the more common standard errors are below. Endpoint specific error messages will be displayed on the page for that endpoint.
Error Code
Description
OK
No error.
NO MATCHING DATA
Returned when supplied parameters have no match. May also be returned when an account has not yet upgraded to a paying account.
FAIL_SIG
Signature doesn't match. Check that your Channel ID is correct for the data you are requesting.
FAIL_PERM
Permissions error – you are trying to undertake an action you do not have permission to perform.
FAIL_TOUROPONLY
The API method called can only be used by tour operators/suppliers, not by agents.
FAIL_KEYNOTFOUND
The key supplied doesn't return a valid connection. Check that your API login details are correct.
FAIL_PARTNERSONLY
/p/calls can only be used with a Marketplace Agent API connection, not a Tour Operator connection. Ensure you send Channel ID0when making/p/calls (API wrappers usually handle this automatically).FAIL_ACTIVEPARTNERSONLY
The Marketplace Agent account may have been deactivated.
FAIL_TIME
The connection is signed with a time value. If a signed request does not reach TourCMS within ±15 minutes, it is rejected. This usually indicates a misconfigured server; check server time and timezone.
FAIL_VERB
Incorrect HTTP verb used – e.g. sending POST when you should use GET, or GET when you should use POST.
WEBHOOK_TIMEOUT
TourCMS contacted an external system to complete an operation, but the external system did not respond within the allocated time.
Remember Marketplace Agents can login to their agent account and review the API error logs.
Don't forget to review the useful background information page!