Errors

{
  "error": {
    "code": "unauthorized",
    "message": "Missing API key (X-API-Key or Authorization: Bearer ...)"
  }
}

​

Common Status Codes

• 400 bad_request: missing/invalid parameters
• 401 unauthorized: missing or invalid API key
• 404 not_found: resource does not exist
• 429: rate limited (when enabled)
• 5xx: server error

​

Retry Guidance

• 400: do not retry without changing the request.
• 401: rotate/fix your key.
• 404: do not retry (unless you expect eventual consistency).
• 429: retry with backoff.
• 5xx: retry with exponential backoff + jitter.