topic
Verified 2026-09-18

RateLimit Header Fields (draft)

The RateLimit-* fields convey quota and reset information for rate-limited APIs.

RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset are widely implemented by gateways despite remaining an unregistered IETF draft. Retry-After stays the standardized retry signal; RateLimit-Reset semantics (seconds versus timestamp) changed between draft revisions, so pin the revision your gateway emits.

httpheaderrate limitapidraft

Reference (http)

RateLimit-Limit: 100
RateLimit-Remaining: 73
RateLimit-Reset: 27

RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset are widely implemented by gateways despite remaining an unregistered IETF draft. Retry-After stays the standardized retry signal; RateLimit-Reset semantics (seconds versus timestamp) changed between draft revisions, so pin the revision your gateway emits.

Common mistakes

  • Treating RateLimit-Reset as a universal contract or relying on the fields for authorization decisions.

Sources

Permalink: https://merginit.com/reference/http/ratelimit-headers