HTTP 429 — Too Many Requests

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

When to use it

Use status 429 when this is the correct HTTP response semantic: The user has sent too many requests in a given amount of time

Request and response example

GET /reports HTTP/1.1
Host: api.example.com

HTTP/1.1 429 Too Many Requests
Retry-After: 60

Related status codes

400, 401, 402, 403

References

MDN · RFC 9110