Rate Limits
Important: Rate limits are in place to prevent API abuse while keeping the service free for everyone. If you need a higher free limit, email contact@muslimbd.app.
Muslim API enforces rate limits to ensure fair usage for all consumers.
Limits by Tier
| Request Type | Without Key | With Valid Key |
|---|---|---|
| General requests | — | 10 / min |
| Calculations (prayer, qibla) | — | 5 / min |
Note: All endpoints require an API key. Rate limits apply per key. Manage keys and authentication at the dashboard: https://api.muslimbd.app/dashboard.
Rate Limit Headers
Every response includes the following headers:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests allowed in the window |
X-RateLimit-Remaining | Requests remaining in the current window |
X-RateLimit-Reset | Unix timestamp when the window resets |
Exceeded Limit Response
When you exceed the rate limit, the API returns 429 Too Many Requests with the request URL and the active rate limit details:
json
{
"status": 429,
"ok": false,
"url": "https://backend.muslimbd.app/api/v1/prayer-time?lat=24.7136&lon=46.6753&method=karachi&school=shafi&date=2026-05-10&api_key=YOUR_KEY",
"data": {
"success": false,
"error": "Rate limit exceeded",
"rateLimit": {
"category": "calculation",
"limit": 5,
"remaining": 0,
"nextResetAt": "2026-05-21T13:02:17.671Z"
}
}
}