title: “Check the current rate limit”
description: “Read the X-RateLimit-* headers to stay within your quota.”
audience: [“developer”]
modules: [“api”]
estimated_minutes: 2
last_reviewed: “2026-05-03”
Check the current rate limit
For: Developer
Last reviewed:
Every response includes three headers: X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (epoch).
TL;DR
Read X-RateLimit-Remaining. If it hits 0 → wait until X-RateLimit-Reset.
Steps
1. On any call read the three X-RateLimit-* headers from the response.
2. If Remaining drops to single digits, slow your flow.
3. If you receive 429 Too Many Requests, read Retry-After (seconds) and wait.
4. Implement exponential backoff with jitter to avoid retry storms.
Was this helpful?id:
check-rate-limitLast updated on