Error handling · Reference
Error code reference
Every error response is a JSON body with a stable code and a human-readable message.
HTTP status codes
| Field | Type | Description |
|---|---|---|
| 400 | Bad Request | Validation failed. Inspect the message field for details. |
| 401 | Unauthorized | Missing or invalid X-API-Key header. |
| 403 | Forbidden | Key valid but lacks permission for the requested resource. |
| 404 | Not Found | The endpoint or resource doesn't exist. |
| 429 | Too Many Requests | Rate limit exceeded. Retry with exponential backoff. |
| 500 | Server Error | Internal server error. Safe to retry idempotent calls. |
| 503 | Service Unavailable | Temporary degradation. Check the status page. |