Error format

JSON error body

Most errors use a single detail string:

{
  "detail": "Human-readable error message"
}

Validation failures return detail as an array of objects:

{
  "detail": [
    {
      "loc": ["body", "email"],
      "msg": "value is not a valid email address",
      "type": "value_error"
    }
  ]
}

Endpoint pages list status codes for each route. In general:

401 — Credentials are wrong, missing, expired, or revoked.
403 — Credentials are valid but access is denied (for example IP blocked, account disabled, feature off).
429 — Rate limit exceeded; use RateLimit headers for backoff.

See Best practices for how to handle 401 vs 403 and throttling.