Error Handling
How to handle API errors gracefully.
Error Format
{
"error": "http_422",
"message": "Validation failed: email is required",
"details": null,
"request_id": "abc123-def456-..."
}Common Status Codes
| Code | Meaning |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad request — check your parameters |
| 401 | Unauthorized — invalid or missing API key |
| 403 | Forbidden — insufficient scope |
| 404 | Not found — resource doesn't exist |
| 409 | Conflict — duplicate resource |
| 422 | Validation error — check request body |
| 429 | Rate limit exceeded — slow down |
| 500 | Server error — retry or contact support |