Pricing and billing

What each call costs, how a paid call is charged, and where to see it.

Calls draw on your organization’s prepaid balance, in US dollars. New accounts get $1 of free calls on their first organization; after that, top up from $10 in the console, or turn on auto-recharge to top up from a saved card when the balance runs low.

Prices

Call	Price
Search people	$0.0001 per person returned
Search companies	$0.0001 per company returned
List a company’s people	$0.0001 per person returned
Run a saved search	$0.0001 per person returned
Everything else: counts, filter values, suggestions, naming a company, saved searches, your account	Free

GET /v1/prices answers the price list in force, with its version. A call pays the prices in force when it started.

How a paid call is charged

1. The most it can cost is held

   Before a search runs, limit times the price is set aside from your balance: 25 people hold $0.0025. If your available balance cannot cover it, the call answers 402 with insufficient_balance, and nothing runs. If it would take the key past its daily cap, it answers 402 with key_daily_cap_reached.

2. It is charged for what it returned

   When the page comes back, the call is charged for the records on it, and the rest of the hold is released. A page of 7 people costs $0.0007.

3. A miss or a failure costs nothing

   A page with nobody on it costs nothing. A call that is refused (any 4xx) or fails on our side (5xx) is never charged, and its hold is released.

See what a call cost

Every answer carries two headers:

Header	What it holds
X-Charged-Usd	What this call cost, such as 0.000700. 0.000000 for a free call.
X-Balance-Usd	The balance after this call.

The same charge shows up in three places:

• GET /v1/requests and GET /v1/requests/{requestId}: every call of the last 30 days, with its cost.
• GET /v1/usage: calls and spend by UTC day, by product and by route.
• GET /v1/wallet/transactions: the ledger, every change to the balance with the balance after it. It needs a key with full access.

GET /v1/wallet answers the balance, what is held for calls in progress, and what new calls can use. See Track your spend.

Money in answers

Amounts are US dollars as exact six-decimal strings, such as "9.999500", never floats. In the ledger, money in is positive and a charge is negative.