All our errors are returned as JSON objects with a status and optionally a message field. The status field is one of the HTTP status codes defined below, and the message is a human-readable explanation of the error.

​
Available error codes

StatusDescription
400Bad request. The request or the request body is invalid. Examples: missing required fields, invalid field format.
401Unauthorized. The request requires authentication. This usually means the API key is missing or invalid.
402Insufficient credits. You do not have enough credits to perform this request. See Credit usage for more information.
403Forbidden. The request is not allowed. This may be due to insufficient privileges or attempting to access resources belonging to another user.
404Not found. The requested resource does not exist. This could be due to an incorrect ID or an invalid endpoint.
429Too many requests. You have exceeded the rate limit. See Rate limiting for more information.
500Internal server error. Something went wrong on our side. If this persists, please contact support with the request details so we can investigate.

​
Example Errors

{
  "status": 400,
  "message": "Invalid query"
}