What this Claude API error means, whether it is on Anthropic’s side or yours, and what to do now. All times are UTC.
Request limit: your account’s pace
This error is about your account’s request limits. Anthropic’s servers answered and turned the request away, which usually means they are up. The live status below helps rule out a wider problem.
Anthropic’s docs give three causes for a 429 rate_limit_error: your organization hit a rate limit, reached its usage tier’s monthly spend cap, or reached a spend limit on the Claude Code workspace.
Anthropic also notes that a sharp increase in usage can trigger 429 errors from acceleration limits, and recommends increasing traffic gradually.
A spend-cap 429 has no retry-after header and keeps failing until access resumes, so retrying does not help in that case.
Shape of the error body, from Anthropic’s docs (the message text varies):
{
"type": "error",
"error": {
"type": "rate_limit_error",
"message": "..."
},
"request_id": "req_..."
}
retry-after header, wait at least that long before retrying. Anthropic’s official SDK does this automatically.retry-after header and every retry fails, you have probably reached your tier’s spend cap: see Anthropic’s rate limits page, linked below.You may not need this: the official SDKs retry on their own (see above). If you call the API directly, this helper waits and retries, using the server’s requested delay when you pass one. Treat this 429 as retryable only while a retry-after header comes back; stop when it does not.
Python
import random
import time
def with_retries(call, is_retryable, retry_after=lambda err: None, attempts=5):
"""Run call(). On a retryable error, wait and try again, up to attempts tries.
retry_after(err) returns the server's requested wait in seconds, or None."""
for attempt in range(attempts):
try:
return call()
except Exception as err:
if attempt == attempts - 1 or not is_retryable(err):
raise
wait = retry_after(err)
if wait is None:
wait = min(60, 2 ** attempt) + random.random() # backoff + jitter
time.sleep(wait)
JavaScript
async function withRetries(call, isRetryable, retryAfter = () => null, attempts = 5) {
// retryAfter(err) returns the server's requested wait in seconds, or null.
for (let attempt = 0; ; attempt++) {
try {
return await call();
} catch (err) {
if (attempt >= attempts - 1 || !isRetryable(err)) throw err;
let wait = retryAfter(err);
if (wait == null) wait = Math.min(60, 2 ** attempt) + Math.random(); // backoff + jitter
await new Promise((resolve) => setTimeout(resolve, wait * 1000));
}
}
}
History logged by OutageRadar.
Full history: Is Claude down?
Source: Claude API errors (Anthropic docs) · Claude API rate limits (Anthropic docs). Last checked against official docs: Nov 10, 2026. If the docs change, they win.