Rate Limits
Islamic API enforces rate limits to ensure fair usage for all consumers.
Limits by Tier
| Request Type | Without Key | With Valid Key |
|---|---|---|
| General requests | — | 5,000 / 15 min |
| Calculations (prayer, qibla) | — | 300 / 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
}