Claude API error 529: overload, evidence and retries
Claude documents 529 overloaded_error as temporary API overload. This is different from a 429 rate or spend limit, and a single response does not establish the reach of an incident.
Quick answer
Claude documents 529 overloaded_error as temporary API overload. This is different from a 429 rate or spend limit, and a single response does not establish the reach of an incident.
Read the response and stream
Claude distinguishes 529 overload from 429 rate limits. It also documents that a streaming error can arrive after HTTP 200; inspect stream errors and completion instead of relying only on response headers.
Recommended application response
For a transient overload response, use a bounded delay and retry budget, considering retries already made by your SDK. Preserve the request ID and request time for troubleshooting. Do not replay downstream agent actions solely because a model request failed.
Compare the Claude API component in the official report with your failure time. The saved Claude report includes multiple products and does not verify every model, account or region. If you call Claude through a router, inspect that router’s error and scope too.
Related service pages
Each entry shows its own collection coverage. A linked service is not necessarily automatically collected.
Editorial review date applies to this guide. Live report collection times appear on the service pages.