Error catalogue
Every Public API error is an RFC 9457 application/problem+json document.
The type links here, to the page for that status.
Shape. Errors carry
type, title, status,
a machine-readable code, a human detail, the instance path,
and a trace_id you can quote to the association when asking for help.
| Status | Code | When it happens |
|---|---|---|
| 400 Bad Request | bad_request | The request was malformed. |
| 401 Unauthorized | unauthorized | No valid API key was supplied. |
| 403 Forbidden | forbidden | The key is valid, but not allowed to perform this request. |
| 404 Not Found | not_found | The resource does not exist. |
| 409 Conflict | conflict | The request conflicts with the current state of the resource. |
| 412 Precondition Failed | precondition_failed | The If-Match precondition did not hold. |
| 422 Unprocessable Entity | unprocessable | The request was well-formed but semantically invalid. |
| 429 Too Many Requests | rate_limited | You have exceeded the rate limit for your key. |
Other 4xx | client_error | A client error not individually listed above (e.g. 405, 415); the type URL resolves here. |
| 500 Internal Server Error | internal_error | Something went wrong on our side. |