Docs / Errors

RATE_LIMIT_EXCEEDED

429Rate limit exceeded

Why it happens

One key sent more than 600 requests within a minute. The burst limit applies to each key on its own, whatever the quota of its project.

What to do

Wait for the Retry-After seconds before you call again.
Spread your calls: queue them rather than fire them all at once, for example when a screen lists many masjids.
Cache what you read: the same masjid's times do not change within the minute.

Example response

http

HTTP/1.1 429 · Retry-After: 60
{
  "type": "https://hub.masjidbox.com/docs/errors/RATE_LIMIT_EXCEEDED",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "Too many requests for this key in the last minute.",
  "instance": "/v1/masjids/msj_abc123defg",
  "code": "RATE_LIMIT_EXCEEDED",
  "requestId": "req_8f14e45fceea167a5a36dedd4bea2543",
  "requestLogUrl": "https://hub.masjidbox.com/console/logs/req_8f14e45fceea167a5a36dedd4bea2543"
}