429 Too Many Requests

What 429 Too Many Requests means {#what}

The client has sent too many requests in a given time window. The server may include a Retry-After header indicating when to try again. The standard response for rate limiting.

When you’ll see a 429 {#when}

• Hitting an API’s rate limit
• Automated scripts hammering an endpoint
• Burst traffic exceeding quotas

When to use 429 {#use}

• Always include Retry-After and/or X-RateLimit-* headers to help clients back off gracefully
• Return clear error messaging with the reset time