Error Codes

The API uses standard HTTP status codes. Error responses include a JSON body with a code and message field.

Error shape

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired API token.",
    "status": 401
  }
}

HTTP status codes

Handling errors

• Treat any 5xx as retryable with exponential backoff.
• Treat 429 as retryable after the X-RateLimit-Reset time.
• Treat 4xx (except 429) as a client error — do not blindly retry.