Rate limits & quotas
Two independent limits apply to every API key: a per-hour rate limit and a per-month usage quota.
Per-hour rate limit
1,000 requests per hour per API key. Exceeding this returns 429 Too Many Requests with a Retry-After header indicating how many seconds to wait.
The window is a rolling 1-hour Postgres bucket; when it rolls over, capacity replenishes.
Per-month quota
Each key has a monthly_quota and usage_current_period. Exceeding the quota returns 429 Monthly quota exhausted.
Defaults by tier:
| Tier | Monthly lookups | Price |
|---|---|---|
| PAYG | 2,000 soft cap | $0.50/lookup |
| 2k Bundle | 2,000 | $499/mo |
| 10k Bundle | 10,000 | $1,999/mo |
| Enterprise | Custom | Contact sales |
What counts as a request
Every successful /v1/*response increments the key's usage counter. /health and 4xx responses do NOT count.