Limits and credits
What a call costs, and how much each plan allows.
Credits
| Call | Credits |
|---|---|
Reading a stored record: GET /v1/companies/{domain}, /by-name, /v1/companies | 1 |
An enrichment: POST /v1/enrichments, each distinct domain of a batch | 10 |
GET /v1/companies/enrich | 1 if it serves a recent record, 10 if it enriches |
| Following an enrichment or a batch | 0 |
Only an answer that's a 2xx costs anything. An enrichment that finds no company is given
back. A retry with an Idempotency-Key is charged once.
Plans
| Plan | Credits a month | Enrichments a month | Most credits a month | Most credits a day | Requests a second, per key |
|---|---|---|---|---|---|
| Free | 1,000 | 100 | 1,000 | 250 | 5 |
| Starter | 25,000 | 2,500 | 75,000 | No daily limit | 20 |
| Growth | 150,000 | 15,000 | 450,000 | No daily limit | 50 |
A paid plan's credits past those included are billed as overage, up to its monthly most. See pricing.
When a limit is reached
| Status | Code | Means |
|---|---|---|
429 | rate_limited | Too many requests a second for the key. Wait the seconds Retry-After gives. X-RateLimit-* headers say where you stand. |
402 | out_of_credits | The workspace has used its credits for the month |
402 | daily_cap_reached | The workspace has used its credits for the UTC day |
429 | test_calls_used_up | The workspace's test keys have made their 1,000 calls today |
429 | test_webhooks_used_up | The workspace's test keys have made 100 requests with a webhook_url today; the same request without one still goes through |