Errors

Understand the error response format and common status codes returned by the API.

Error Format

All API errors return a consistent JSON object containing a single error field with a descriptive message.

Error Response

{
  "error": "Detailed error message explaining what went wrong."
}

HTTP Status Codes

400Bad Request

The request was invalid or cannot be otherwise served. This usually means a missing required parameter or a validation error (e.g., invalid date format).

401Unauthorized

Authentication failed. Ensure your API key is provided correctly in the Authorization header.

404Not Found

The requested resource (e.g., a specific job ID) or endpoint does not exist.

429Too Many Requests

Rate limit exceeded. Check the error message for details on your tier's limits.

500Internal Server Error

Something went wrong on our end. We've been notified and are looking into it.

Rate Limiting

Rate limits are applied per API key. Check the error message for details on your tier's limits. If you are experiencing issues, please contact support.