Rate Limits & Caching

BDApi4All is free and no-auth for basic use. The public limit is 100 requests per minute per IP.

Headers

X-RateLimit-Remaining: Requests remaining in the current minute window.
X-Response-Time: Server-side response time measured by BDApi4All.
Cache-Control: Recommended CDN/browser cache policy for the response.
Retry-After: Seconds to wait after a 429 response.

Cache TTL

Geo data	24 hours
Prayer times	1 hour
Holidays	24 hours
Exchange rates	1 hour
Validators	10 minutes
Utilities	1 hour

429 Example

{
  "success": false,
  "version": "v1",
  "timestamp": "2026-06-02T00:00:00.000Z",
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded.",
    "docs": "https://bdapi4all.vercel.app/docs/errors#rate_limited"
  }
}