Errors
Error Responses
The API uses standard HTTP status codes. Error responses include a JSON body with details.
400 — Bad Request
The request is malformed or missing required parameters.
{"detail": "X-API-Key must not be empty"}
401 — Unauthorized
The API key is invalid or has been revoked.
{"detail": {"error": "invalid_api_key", "revoked": false}}
429 — Too Many Requests
Rate limit exceeded. Wait before retrying.
{"detail": "Rate limit exceeded"}
500 — Internal Server Error
An unexpected error occurred on the server.
{"detail": "Internal server error"}