Skip to main content

Client Error (4xx)

HTTP/1.1

429 Too Many Requests

The user has sent too many requests in a given amount of time.

CategoryClient Error (4xx)
API error types2 error schemas
Related headers11 headers
Defined inRFC 6585
Updated2026-10-14

What does HTTP status code 429 mean?

The 429 Too Many Requests status code indicates that the client has exceeded their allowed rate limits or quotas.

When to use it in APIs

Standard response for rate limiters. Include Retry-After to say when to try again, and the RateLimit and RateLimit-Policy fields to show the remaining quota and the policy that was exceeded.

How it compares to other codes

  • 503 Service Unavailable: Represents a server-side capacity outage. 429 represents a client-side quota violation.

Problem types for 429

2
11