Limits by Plan
Each plan has different daily request limits and per-second rate limits.
| Plan | Daily Requests | Rate Limit | Historical Data | API Keys |
|---|---|---|---|---|
| Starter | 500/day | 5 req/sec | 30 days | 1 |
| Pro | 2,000/day | 15 req/sec | 90 days | 3 |
| Business | 6,000/day | 50 req/sec | All available | 10 |
| Enterprise | Unlimited | Custom | All available | Unlimited |
Rate Limit Headers
Every API response includes headers to help you track your usage:
| Header | Description |
|---|---|
X-RateLimit-Limit | Your daily request limit |
X-RateLimit-Remaining | Requests remaining today |
X-RateLimit-Reset | Unix timestamp when limit resets (midnight UTC) |
X-RateLimit-Used | Requests used today |
HTTP/1.1 200 OK
X-RateLimit-Limit: 500
X-RateLimit-Remaining: 423
X-RateLimit-Used: 77
X-RateLimit-Reset: 1704067200When You Exceed Your Limit
If you exceed your rate limit, you'll receive a 429 response:
HTTP/1.1 429 Too Many Requests
Retry-After: 3600
Content-Type: application/json
{
"detail": "Daily rate limit exceeded. Resets at midnight UTC."
}Tip: Use the Retry-After header to know when you can make requests again.
Best Practices
Cache responses
Store API responses locally to avoid redundant requests. Application data typically changes once per day.
Use webhooks instead of polling
Pro and Business plans include webhooks. Get notified of new applications instead of repeatedly checking.
Implement exponential backoff
When rate limited, wait progressively longer between retries (1s, 2s, 4s, 8s...).
Request only what you need
Use filters to narrow results. Requesting all applications when you only need one council wastes your quota.
Monitor your usage
Check the Usage Dashboard to track your API consumption patterns.
Need Higher Limits?
Upgrade your plan for more daily requests and faster rate limits.