Working with the API
Errors
How failures are reported.
Errors return a JSON body with a detail field. Validation errors return a list describing which field failed.
{ "detail": "Invalid or missing API key." }
{ "detail": [ { "loc": ["body", "query"], "msg": "Field required", "type": "missing" } ] }
| Status | Meaning |
|---|---|
| 200 | Success |
| 400 | Invalid request |
| 401 | Missing or bad key |
| 402 | Out of credits |
| 404 | Unknown id |
| 422 | Validation failed |
| 429 | Rate limited (see Retry-After) |
Failed requests are not charged.
Last modified on October 20, 2026
Was this page helpful?