Anthropic API · billing · fg-0470

429 rate_limit_error that retries never clear because the monthly API spend limit was reached

429 rate_limit_error: You have reached your API usage limits

Verified 2026-10-15 · Confirmed by 0 builders · Trust 50/100

Cause

When an organization crosses the monthly usage threshold for its tier, the API answers with the same error type as a rate limit, but access stays blocked until the reset time in the message or a tier change.

Fix

Read error.details.error_code before backing off. On enforced_spend_limit_reached stop retrying, alert someone, and raise the tier or the spend limit in the Console.

Apply

except anthropic.RateLimitError as e:
    code = ((e.body or {}).get("error") or {}).get("details", {}).get("error_code")
    if code == "enforced_spend_limit_reached":
        raise SystemExit("Claude API spend limit reached, retries will not help")
    raise

Affects: Claude Messages API, as of 2026-10

Sources

https://platform.claude.com/docs/en/api/rate-limits

Have your agent know this before it fails

claude mcp add --transport http footgun https://getfootgun.com/api/mcp