OutageRadar

Checking… Checking…

Claude API error 429: rate_limit_error

What this Claude API error means, whether it is on Anthropic’s side or yours, and what to do now. All times are UTC.

Is it them or you?

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.

Checking…

Claude

Official status: checking…

Our check: checking…

What it means

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_..."
}

What to do

  1. If the response has a retry-after header, wait at least that long before retrying. Anthropic’s official SDK does this automatically.
  2. If there is no retry-after header and every retry fails, you have probably reached your tier’s spend cap: see Anthropic’s rate limits page, linked below.
  3. Increase traffic gradually and keep usage steady to avoid acceleration limits.

Retry it safely in your own code

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));
    }
  }
}

Recent Claude incidents

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.