Error Codes
When interacting with our Content API it is possible that you may encounter the following error codes in response to your requests. This list may change in future and so your integration should be built to handle additional error codes as and when they are introduced. Where possible, the system will return helpful human-readable error messages in addition to the error codes below to indicate the nature of the problem.
System Errors
| Error Code | Error Description |
|---|---|
|
SERVER_500 |
The system displays both errors: ‘Agency or user does not have access’ and ‘System error occurred.’ |
|
SERVER_401 |
Invalid credentials |
|
SERVER_404 |
Endpoint not found |
|
SERVER_400 |
Please provide valid credentials |
|
COUNTRY_404 |
No countries found |
|
Region_404 |
No Region found for given country |
|
Country_404 |
Please provide valid country |
|
Hotels_Country_404 |
No hotels found for the given country |
|
Hotels_City_404 |
No hotels found for the given City |
|
City_404 |
Please provide valid City |
|
HotelIds_404 |
Too many hotel ids to process. Can process only 100 hotels at a time. |
|
Hotels_404 |
No Hotel details found |
|
AUTH_400 |
Please provide valid credentials |
|
AUTH_401 |
Invalid credentials |
HTTP Status Errors
| Status Code | Error Type | Description (Web API Context) |
|---|---|---|
|
200 OK |
Success |
The request was successful, and the response body contains the requested data. |
|
201 Created |
Success |
A new resource has been successfully created on the server. |
|
202 Accepted |
Success |
The request has been accepted for processing but not yet completed. |
|
204 No Content |
Success |
Request processed successfully, but there is no content to return. |
|
400 Bad Request |
Client Error |
The request is invalid due to malformed syntax or missing parameters. |
|
401 Unauthorized |
Client Error |
Authentication is required or has failed (invalid token or credentials). |
|
403 Forbidden |
Client Error |
The client is authenticated but does not have permission to access the resource. |
|
404 Not Found |
Client Error |
The requested resource or endpoint does not exist. |
|
405 Method Not Allowed |
Client Error |
The HTTP method used (GET, POST, PUT, etc.) is not supported for this endpoint. |
|
406 Not Acceptable |
Client Error |
The requested response format (e.g., JSON/XML) is not supported. |
|
408 Request Timeout |
Client Error |
The server timed out waiting for the client’s request. |
|
409 Conflict |
Client Error |
The request could not be completed due to a conflict in resource state. |
|
415 Unsupported Media Type |
Client Error |
The request format (e.g., Content-Type) is not supported by the server. |
|
422 Unprocessable Entity |
Client Error |
The server understood the request but couldn’t process it due to semantic errors. |
|
429 Too Many Requests |
Client Error |
The client has sent too many requests in a short time (rate limiting). |
|
500 Internal Server Error |
Server Error |
Generic error — something went wrong on the server. |
|
501 Not Implemented |
Server Error |
The server does not support the requested functionality. |
|
502 Bad Gateway |
Server Error |
The server received an invalid response from an upstream server. |
|
503 Service Unavailable |
Server Error |
The server is temporarily unavailable (maintenance or overload). |
|
504 Gateway Timeout |
Server Error |
The upstream server did not respond in time. |
Response Samples
Samples
