Rate Limits
Understand Filed API rate limits, credit costs per endpoint, and plan tiers.
Plan Limits
| Plan | Monthly Credits |
|---|---|
| Developer | 1,000 |
| Business | 10,000 |
| Scale | 50,000 |
All plans share the same per-minute rate limit of 60 requests per minute, applied per API key. For plan prices, see pricing.
Per-Request Limits
These apply on every plan, and they are the two numbers most often needed when sizing a job:
| Limit | Value |
|---|---|
Maximum batch size (POST /api/v1/batch) | 25 queries per request |
Cross-state query — no state parameter | 5 credits instead of 1 |
A batch of more than 25 queries is rejected with invalid_params; split the work across requests. The 5-credit
cross-state cost applies to any search without a state parameter, not just inside a batch, and an officer
search costs 5 credits even when a state is given.
Need more than 50,000 credits a month or 25 queries per batch request? Talk to us about volume.
Credits Per Endpoint
Different endpoints cost different numbers of credits:
| Endpoint | Credits |
|---|---|
/api/v1/search | 1 |
/api/v1/entity/{id} | 1 |
/api/v1/entity/{id}?include=federal | 3 |
/api/v1/batch (per query) | 1 (+2 with federal) |
/api/v1/sec/search | 2 |
/api/v1/lobbying/search | 2 |
/api/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 if you need more than the self-serve ceiling, contact us about volume.