`RateLimit-Reset` Header

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

Header TypeResponse Header

SpecificationCustom / Draft Extension

Associated CodesHTTP 429

What is the RateLimit-Reset header?

The RateLimit-Reset response header indicates the time remaining until the client request quota is reset.

API Usage & Best Practices

IETF Draft Specs: Standardized to express the countdown in seconds remaining (e.g. RateLimit-Reset: 42), replacing old custom implementations that returned epoch timestamps.

Examples

HTTP/1.1 200 OK
RateLimit-Reset: 16

Associated HTTP Status Codes

HTTP 429 — Too Many Requests

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

View reference →

Sponsors

Support the project →