Rate Limits

Every API key has a request quota and a per-second rate limit based on your platform subscription tier.

Limits by tier

Tier	Requests	Burst Rate	Sustained Rate	Price
Free	100 lifetime	2 req/s	1 req/s	$0/mo
Pro	1,000/day	20 req/s	10 req/s	$149/mo
Enterprise	5,000/day	100 req/s	50 req/s	$499/mo

note

Basic plan subscribers receive Free tier API access (100 lifetime requests).

How limits work

• Free tier — you get 100 requests total for the lifetime of your account. Once used, upgrade to Pro for daily limits.
• Pro/Enterprise daily quota resets at midnight UTC every day
• Burst rate is the maximum number of concurrent requests allowed in a short window
• Sustained rate is the average requests per second over a longer period

Response headers

Every response includes rate limit information in headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 823
X-RateLimit-Reset: 1709251200

Header	Description
X-RateLimit-Limit	Your request quota (daily for Pro/Enterprise, lifetime for Free)
X-RateLimit-Remaining	Requests remaining until limit
X-RateLimit-Reset	Unix timestamp when the counter resets (Pro/Enterprise only)

When you're rate-limited

If you exceed your quota, you'll receive a 429 Too Many Requests response:

{
  "success": false,
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Daily request limit exceeded. Resets at 2025-03-01T00:00:00Z."
  },
  "meta": {
    "request_id": "req_xyz789"
  }
}

For Pro/Enterprise tiers, the response includes a Retry-After header with the number of seconds until the daily limit resets. Free tier users who have exhausted their lifetime quota will need to upgrade.

Best practices

• Cache responses — filing data doesn't change frequently, so cache results client-side
• Use filters — narrow your queries with county, amount, and date filters instead of fetching everything
• Paginate efficiently — fetch only the pages you need rather than iterating through all pages upfront
• Monitor usage — check X-RateLimit-Remaining headers to avoid hitting limits
• Upgrade proactively — if you regularly approach your limit, consider upgrading your tier