HTTP Headers

Important information about rate limits such as the remaining requests, tokens, and other metadata is present in the headers of the HTTP response. The following headers are made available:

  • RateLimit-Limit: The rate limit ceiling for that given endpoint.
  • RateLimit-Remaining: The number of requests left for the window.
  • RateLimit-Reset: The remaining window before the rate limit resets (in seconds).
  • RateLimit-Policy: Returns the quota policy. For example, a quota policy of 100;w=60 can be read as 100 requests per 60 seconds.

In case of a 429 response (too many requests), the following header is also attached:

  • Retry-After: Time after which the rate limit is reset (in seconds).