Response shape
Error responses are JSON objects. Fields may include a message, validation details, or error codes depending on the endpoint. Inspect the response body alongside the status code.HTTP status reference
| Code | When it applies |
|---|---|
| 400 | Bad request — malformed input or failed request validation. |
| 401 | Unauthorized — missing or invalid API key. |
| 403 | Forbidden — insufficient permissions for the resource or action. |
| 404 | Not found — resource does not exist or is not visible to this key. |
| 422 | Unprocessable entity — semantic validation failed (e.g. business rules). |
| 429 | Too many requests — rate limit exceeded; see Rate limiting. |
| 500 | Unexpected server error — retry with backoff; contact support if it persists. |
Retries
- 429 and 5xx are often retryable with exponential backoff and jitter.
- 400, 401, 403, 404, and 422 usually need a fix to the request or permissions — retrying the same payload will not help.