Pricing

How is a check counted?

A check is one identifier (a phone number or an e-mail address) run against one service. A lookup of 10 numbers with checks: ["whatsapp", "telegram"] contains 20 checks. Each check is billed on its own, and only when its answer is conclusive:

• Account checks (for example "registered on Telegram"): billed for registered: true or false. Not billed for null.
• Data checks (for example the carrier lookup): billed when the answer carries the service's main data, such as a carrier. "No data" comes back as unknown and is free.
• Spam reputation: every level, including no_reports, is a conclusive answer and is billed. Unknown and unsupported-country results are free.
• HLR lookup: reachable, unreachable and invalid (the network reports the number as not assigned) are billed. unknown is free.
• MNP lookup: ported and not_ported are billed. unknown is free, and so are numbers the lookup can't place on a network.

Invalid numbers, invalid e-mail addresses, duplicates within a request, suppressed identifiers and numbers from sanctioned countries and regions are never checked, so they never cost anything. Each result shows billed: true or false, so you can reconcile every charge.

How does the balance work?

Your account has a prepaid USD balance. When you send a request, we reserve the most it could cost, meaning every billable check answering conclusively. As answers arrive, we charge only the conclusive ones and give the rest back to your available balance. For a bulk job you can follow this in the job's cost object: estimated_max, reserved, charged and released.

If your balance can't cover the maximum cost, the request is refused with insufficient_balance before anything is checked. GET /v1/account shows your balance, the amount currently reserved and today's usage.

How do I control spend?

• max_cost on any lookup or job: if the most the request could cost is higher, it's refused with cost_limit_exceeded and nothing is charged.
• Free estimates: POST /v1/jobs/estimate returns the maximum cost of a list before you commit.
• Caching: repeat checks inside the freshness window come from your account's cache and are free (cached: true, billed: false). Send max_age: 0 only when you need a fresh answer.
• Daily caps: each account has a daily cap on numbers, and agent keys can have a daily spend cap. GET /v1/limits shows both.
• Test keys: build and test your integration for free with the test numbers.

Real time or bulk: which price applies?

The price depends on how you send the check. POST /v1/lookup uses the real-time price. POST /v1/jobs uses the bulk price, whatever the service, with one exception: WhatsApp checks get the bulk price for groups of at least 132 numbers from the same country in one job. A smaller group, such as a few numbers from another country in a mixed list, is priced at the real-time price. From 2026-11-03 the same applies to X checks, with a minimum of 1,000 numbers from the same country. The free estimate shows these checks separately (breakdown, reason small_batch) before anything runs, and the bulk jobs guide explains how to avoid it. Some services, such as the Signal, iMessage and RCS checks, are available in bulk jobs only. For those, the pricing table shows only the bulk price.

Is there a minimum per country for bulk-only checks?

Yes. A bulk-only check always runs as a bulk job, and each country in a job is processed on its own, so each country has a minimum charge: the price of 500 checks of that service. For a check that costs $0.0005 that is $0.25 per country. From 2026-11-03 the minimum for the TikTok, LINE, LinkedIn, Snapchat and Messenger checks is the price of 2,000 checks, because each country file of these checks has a higher fixed cost. Each country (the numbers of one country for one check in one job) is billed the larger of its conclusive answers × the bulk price and that minimum, and only when it returns at least one conclusive answer. A country whose answers are all unknown or unsupported costs nothing.

For example, 494 numbers spread over 55 countries for the RCS check cost at most 55 × $0.25 = $13.75 (at the RCS bulk price of $0.0005 as of 2026-10-17), while 600 numbers from one country cost 600 × $0.0005 = $0.30 when all of them answer. The minimum also applies to a country with 500 or more numbers, but it only makes a difference when fewer than 500 of them return an answer. The free estimate lists the countries below the minimum (breakdown, reason country_minimum) and includes the minimum in max_cost before anything runs; whatever is not used is released when the job finishes. To keep the cost per number at the bulk price, send at least 500 numbers per country, or collect small lists by country into fewer, larger jobs. Checks that also have a real-time price are not affected by this minimum.

Use real time when a person or a process is waiting for the answer, for example during sign-up. Use bulk for lists, scheduled refreshes and anything that can wait a few minutes.

Do larger top-ups get bonus credit?

Yes. When you top up by card, larger amounts add bonus credit on top of what you pay. The tier depends on the amount of that one top-up:

You are charged exactly the amount you top up; the bonus is added as a separate "Top-up bonus" line in your balance history right after the payment is confirmed (after any balance owed is repaid). Bonus credit is spent like paid credit, at the same prices, and it does not expire while your account is active. It is promotional credit: it can't be paid out, and if a top-up is refunded or charged back, the bonus from that top-up is removed in proportion, from the credit still available. The dashboard shows the bonus before you pay. We may change or end the bonus tiers for future top-ups; a change never affects bonus credit already added. See billing.

Are there volume prices?

For large or committed volumes, tell us your expected monthly volume and services when you request access. We will discuss committed-volume pricing with you. Price increases are announced at least 14 days in advance. The price that applies to a request is fixed when the request is accepted.

How do these prices compare with other providers?

Providers count and bill checks differently: some charge for every lookup, including failed ones, and some sell monthly plans. Compare the cost per conclusive answer on your own numbers. Our phone validation API comparison sets eight providers side by side on dated public evidence, with a bake-off script you can run yourself. The comparison hub explains how to compare fairly.