Skip to main content
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