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. Generate your key →
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:
json
{
"success": false,
"error": "Too Many Requests",
"message": "Rate limit exceeded. Please wait before retrying.",
"retry_after": 60
}