Rate Limits
Understand Filed API rate limits, credit costs per endpoint, and plan tiers.
Plan Limits
| Plan | Monthly Credits | Rate Limit | Price |
|---|---|---|---|
| Free | 100 | 10 req/min | $0 |
| Developer | 1,000 | 60 req/min | $29/mo |
| Business | 10,000 | 120 req/min | $99/mo |
| Scale | 50,000 | 300 req/min | $299/mo |
Credits Per Endpoint
Different endpoints cost different numbers of credits:
| Endpoint | Credits |
|---|---|
/v1/search | 1 |
/v1/entity/{id} | 1 |
/v1/entity/{id}?include=federal | 3 |
/v1/batch (per query) | 1 (+2 with federal) |
/v1/sec/search | 2 |
/v1/lobbying/search | 2 |
/v1/contracts/search | 2 |
Batch Credit Calculation
For batch requests, credits are calculated per query:
- Basic query: 1 credit each
- Query with
include: "federal": 3 credits each - Cross-state query (no state specified): 5 credits each
Example: A batch of 3 queries where 1 has federal enrichment = 1 + 1 + 3 = 5 credits total.
Exceeding Your Limits
When you exceed your monthly credit allowance, the API returns a 429 status code with details about when your limit resets. Per-minute rate limits also return 429 but reset within 60 seconds.
Need more credits? Upgrade your plan or contact us for custom enterprise pricing.