Anthropic Claude API
Anthropic API errors and fixes
13 Anthropic API errors from the official error docs, grouped by HTTP status, each with what it means, why it happens, the documented fix and whether to retry. Verified .
- Official error docsplatform.claude.com
- Status pagestatus.claude.com
- Anthropic API rate limits
Error response body
The shape Anthropic API errors come back in, as the official docs show it. Read the status and error type from here before matching an entry below.
JSON
{
"type": "error",
"error": {
"type": "not_found_error",
"message": "The requested resource could not be found."
},
"request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}HTTP 400 Bad Request
400 invalid_request_errorThere was an issue with the format or content of your request. This error type may also be used for other 4XX status codes not listed in the docs.Retry? Not stated400 invalid_request_error (spend limit reached)When usage reaches an organization or workspace spend limit you set, requests return HTTP 400 with error type invalid_request_error. The message begins "You have reached your specified API usage limits" (or "You have reached your specified workspace API usage limits" for a workspace limit) and states when access resumes. Limits on the Claude Code workspace are the exception: Claude Code requests over that workspace's limit can instead receive a 429 that carries a retry-after header.Retry? Not stated
HTTP 401 Unauthorized
HTTP 402 Payment Required
HTTP 403 Forbidden
HTTP 404 Not Found
HTTP 409 Conflict
HTTP 413 Content Too Large
HTTP 429 Too Many Requests
429 rate_limit_errorYour organization has hit a rate limit. The 429 error describes which rate limit was exceeded, and when the response has a retry-after header you should wait that many seconds before retrying. Fast mode rate limits also return a 429 with a retry-after header.Retry? Yes429 rate_limit_error (enforced_spend_limit_reached)Your organization reached its usage tier's monthly spend cap. API usage pauses until 00:00 UTC on the first day of the next month. The error type is rate_limit_error, but the response has no retry-after header. On the Messages API, error.details.error_code is enforced_spend_limit_reached.Retry? No
HTTP 500 Internal Server Error
HTTP 504 Gateway Timeout
HTTP 529
Newsletter
Know when the APIs change
One email per week. New model releases, API changes, what broke, and how developers are working around it.