Credits

Lookups are paid in credits. You are charged only when we find a record.

What each lookup costs

Endpoint	Hit	Miss
Company profile `/v1/companies/profile`	2 credits	0
Email finder `/v1/email/finder`	1 credit	0
Credit balance `/v1/account/credits`	Free	0

When we charge

Only when found is true

Every response reports what it cost in credits_consumed.

Never for a failure

Misses, validation errors, rate limits, source outages and our own bugs all cost nothing.

Running out

We check your balance before the lookup runs. If you do not have enough credits to cover the request, you get 402 out_of_credits and nothing is spent.

HTTP 402

{
  "error": "out_of_credits",
  "message": "Not enough credits. Upgrade your plan or wait for your next renewal."
}

Checking your balance

GET /v1/account/credits returns your current balance. It is free.