Skip to main content
Your account balance is held in US dollars. Every billable result deducts a small dollar amount from that balance. Throughout the docs you may see the word credit — read it as one billable result, priced in USD as shown below.

​
Standard prices

These are the starting per-result prices (before any volume discount — see Spend & Save tiers). Your effective price only goes down as your lifetime spend grows; your current rate is always shown in your billing settings.
Prices above are the Tier 0 (standard) rate. The more you spend over the lifetime of your account, the higher your discount tier and the lower every price becomes — automatically. See Spend & Save tiers.

​
How a charge is calculated

Every API response reports exactly what it cost in meta.amount_charged (USD), so you never have to guess after the fact.

​
What’s free

  • Database (cached) count endpoints (POST /search/database/*/count/) — a cached count, no charge.
  • Account, status, and webhook endpoints.
  • Not-found results on enrich, phone, and email find (see below).
Real-time count endpoints (POST /search/realtime/*/count/) are not free — each costs $0.02, because they hit live sources. Use the free database count to size an audience before paying.

​
No Data, No Charge — exactly where it applies

You are not billed for results we don’t return:
Email Validation is the one case where every submitted address is billed: validation is the deliverable, so each checked email costs $0.005 regardless of its verdict.

​
Worked example

You enrich 100 leads in real time; 92 are found, 8 are not.
  • 92 × 0.02=∗∗0.02 = **1.84** charged
  • 8 not-found → $0.00 (refunded)
  • meta.amount_charged returns 1.84

​
When your balance hits $0

The exact sequence, so production behavior is predictable:
  1. Credits are reserved up front when a request or bulk job is accepted — anything already accepted runs to completion and is never interrupted mid-flight.
  2. A submitted bulk job keeps processing even if your balance reaches $0 afterwards — its cost was reserved at submit time.
  3. New billable requests are rejected with 402 and "Insufficient funds in the account." (standard error envelope) until you top up.
  4. Free endpoints (database counts, account, status polling, webhooks) keep working at $0.
Enable Auto Top-Up to make this state unreachable in production.

​
Testing without spending

There is no separate sandbox environment — the live API is safe to evaluate for free:
  • Database count endpoints are free — size any audience at $0.
  • Preview returns real (masked) leads at $0.002/result.
  • New accounts start with a free starter credit, and not-found results are never billed — a failed experiment costs nothing.
  • Every response tells you what it actually cost (meta.amount_charged), so a $1 test budget goes a long way.

​
Keeping a positive balance

API usage requires a positive balance. If it reaches $0, requests stop until you top up. Enable Auto Top-Up so production traffic never halts. New accounts start with free credit to try the API — your current balance is shown in your billing settings.