> ## Documentation Index
> Fetch the complete documentation index at: https://docs.behaviq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

BehavIQ returns JSON errors with a `code` and `message`.

The most common status codes are:

* `401` missing or invalid API key
* `402` billing or usage limit reached
* `403` key is not allowed to call that endpoint
* `429` rate limited
* `5xx` transient server error

## Retry guidance

Retry these:

* `429`
* `500`
* `502`

Do not blindly retry these:

* `401`
* `402`
* `403`
* `404`

Those usually need a request or config fix.

Common `402` codes include:

* `credits_required`
* `member_usage_limit_reached`
* `api_key_credit_cap_reached`
* `user_credit_cap_reached`
* `org_credit_cap_reached`
* `billing_not_configured`

## Example error

```json theme={null}
{
  "error": {
    "code": "member_usage_limit_reached",
    "message": "This member has reached their usage limit."
  }
}
```