Error Handling

The API uses standard HTTP status codes to indicate success or failure of a request. Below are the common error codes and their meanings:

HTTP Status Codes

• 400 Bad Request: The request was unacceptable, often due to missing a required parameter.

• 401 Unauthorized: No valid API key provided.

• 402 Request Failed: The parameters were valid but the request failed.

• 403 Forbidden: The API key doesn't have permissions to perform the request.

• 404 Not Found: The requested resource doesn't exist.

• 429 Too Many Requests: Too many requests hit the API too quickly. We recommend an exponential backoff of your requests.

• 500 Internal Server Error: An unexpected error occurred on the server.

Error Response Format

Error responses follow this standard format:

{
  "status": "error",
  "message": "Error message",
  "data": null
}

Rate Limiting

When you exceed the rate limit (429 error), implement exponential backoff by increasing the delay between requests after each retry attempt.