Plans & billing
How the allowance works
One allowance, two rolling windows, every activity at its own weight — in plain language.
If you have used an AI chat plan, you already know the shape: one allowance, two rolling windows — the last 5 hours and the last 7 days.
One allowance, counted in records
Every company or person we show you is one record — every time it is shown, whether in a search, a lookup or an export file:
| Activity | Costs |
|---|---|
| A company in a search, lookalike or lookup result | 1 record |
| A person in a people search or lookup, with or without contact details | 1 record |
| A row in an export file (company or person) | 1 record |
| Counting, filters, segment summaries, reading a company’s page text | nothing |
| Finding or verifying an e-mail address | nothing |
A search that returns 50 companies takes 50 records; the 10 people you then look up at them, 10 more.
The weights for your account are in get_usage → meter.
A call that fails costs nothing. A retried call or job is never charged twice.
Two rolling windows
Your allowance is checked against two windows at once:
- The last 5 hours. A speed bump. It stops an agent that has gone into a loop, or someone trying to copy the database — not a person doing their job.
- The last 7 days. This one is the plan. Unlimited has no 5-hour window — only this one.
Both windows roll. Nothing resets at midnight or on the first of the month: each record frees up exactly 5 hours, or 7 days, after you used it. The allowance trickles back continuously instead of arriving in a lump and expiring unused.
On Unlimited there is no 5-hour window: the work can come in bursts as large as the week allows.
What happens at a limit
You get a plain message — in the dashboard, in the API and to your agent — saying which window is full and exactly when enough frees up:
5-hour allowance used up (250/250 records) — enough frees up at 17:42 (in 38 min); the window is rolling, so it trickles back continuously.
Everything that costs nothing keeps working in the meantime, and an export is automatically capped at what you have left rather than refused.
Checking where you are
- Dashboard → Billing shows both windows.
- Your agent: “how much do I have left?” — it calls
get_usage. - API:
GET /v1/usage.
Related
- Plans
- I hit a limit
- Records & rate limits — the API-side detail