Billing and fair use

You pay per address you get, never per call we make to a source. Whether the answer comes from our own data or from a paid source is our cost, not yours.

What is billed#

• A resolve that finds the address. The same id at most once.
• A lookup that finds exactly one address.

Never billed: suggest, a lookup with multiple or not_found, a repeated resolve, usage, and every error.

Prices#

Every supported country is paid only: each address is billed from the first one, without a free allowance. Prices exclude VAT. The tier is counted per country and per UTC month; each address is billed at the tier it falls in.

You get an invoice for each month with paid usage, in your dashboard.

Fair use#

Calls that are not billed still cost us something where the source is paid. So unpaid calls share an allowance per account and month: 2,000 units, plus 20 for every billed address. When it is used up, suggest, every lookup on a paid source and repeated resolves get 429 fair_use_exceeded until the next month. Resolving a new id keeps working and extends the allowance. Lookups in Switzerland, Czechia, Denmark, Estonia, France, Lithuania, Latvia, Netherlands, Slovenia, Slovakia are never held back: they cost us nothing.

Units per unpaid call; a dash where the source does not answer that call. Unpaid: a repeated or not-found resolve, a lookup with multiple or not_found. A resolve of a lookup's id weighs as the lookup.

Limits on your account#

• Paid usage. Without it, a paid-only country answers 402 payment_required before anything is looked up.
• Monthly spend cap. An address that would take you over it is refused with 429 spend_cap_reached.
• Your numbers. GET /v1/usage and the dashboard show this month’s usage and spend.