The API returns standard HTTP status codes to indicate the success or failure of a request. In general, status codes in the 2xx range indicate a successful request, status codes in the 4xx range indicate errors caused by an incorrect input (for example, providing incorrect API key), and status codes in the 5xx range indicate an error on our side.
Status code
Description
400Bad Request
The request was not understood.Check if your request is missing a required parameter or contains an invalid query parameter value.
401
Unauthorized
The provided API key is doesn't provide access to the requested resource. The error can also occur if the API key is malformed or missing.Try copying and pasting your current API key to avoid typos.
403Forbidden
The provided API key is valid but doesn't provide permission for the specified resource.
404Not Found
The requested resource doesn't exist.Try checking the resource name for typos.
405Method Not Allowed
The requested HTTP method is not supported for the specified resource.
429Too Many Requests
The rate limit for the API has been exceeded. Try your request again after a few seconds as specified in the Retry-After header.
5xxInternal Error or Service Unavailable
Something went wrong on our side. Try your request again after a few seconds and use a retry policy.
For troubleshooting failed requests, the API provides error messages defined in a consumable format to help you identify and fix the issue.
Only useful for finding reasons behind failed requests in specific cases.
Resolving errors
If you cannot identify and resolve an issue with your API call, you can contact our Support team with the response status and request ID from the error response, and we’ll help you troubleshoot.
The error message explaining what caused the error.
The performed request's unique ID.
The internal error code for the type of error. Used for finding patterns among error requests.
JSON
{ "message": "The continuation token specified in the 'X-Continuation' request header is malformed.", "request_id": "d9b4b4e4750ee210", "error_code": 107, "specific_code": 0}