HTTP 429 — Too Many Requests

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

Status CodeHTTP 429

CategoryClient Error (4xx)

API Error Subtypes1 error schema

HTTP Headers4 headers

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.

Standard response for rate limiters. Include headers indicating limit, remaining quota, and time until reset (Retry-After).

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

Custom error schema (Slug: rate-limit-exceeded)

Indicates the maximum number of requests the client is permitted to make in the current rate window.

Indicates the remaining number of requests the client is allowed to make in the current rate window.

Indicates the number of seconds remaining until the current rate window resets.

Tells the client how long to wait before making a follow-up request.

The server is temporarily down or overloaded. The client should retry.