Credits and billing
Lookups are paid for with credits. Your plan includes credits every month, and anything beyond that is billed pay as you go, up to a limit you set.
What a credit is
A credit is the unit you spend on lookups. One balance covers all 79 products, through the API, the dashboard and the MCP server. Each product has a published price in credits, shown on its endpoint page and in the catalog.
| Product | Price | Charged per |
|---|---|---|
| Phone Validation | 1 credit | lookup |
| Email Validation | 1 credit | lookup |
| Carrier Lookup | 3 credits | lookup |
| HLR Lookup | 5 credits | lookup |
| DNC Scrub | 10 credits | lookup |
A price marked from is a starting price. Products charged per match cost nothing when no match is found.
Plans
Every account is on a monthly plan. A plan includes a number of credits each month, and every plan includes every product. Paying yearly costs less per month.
| Plan | Per month | Billed yearly | Credits each month | Per 1,000 included |
|---|---|---|---|---|
| Starter | $29 | $24 a month | 6,000 | $4.83 |
| Growth | $99 | $82 a month | 25,000 | $3.96 |
| Pro | $299 | $249 a month | 90,000 | $3.32 |
| Scale | $799 | $666 a month | 300,000 | $2.66 |
| Enterprise | Custom | Custom | From 1,000,000 | Custom |
Unused credits carry forward for 3 months and then expire. Manage your plan under Settings, Billing in the dashboard.
Pay as you go
When your included credits run out, lookups keep working. Extra credits are added 1,000 at a time at your plan's pay-as-you-go rate, until you reach the monthly limit you set.
| Plan | Pay-as-you-go rate |
|---|---|
| Starter | $5.00 per 1,000 credits |
| Growth | $4.50 per 1,000 credits |
| Pro | $4.00 per 1,000 credits |
| Scale | $3.50 per 1,000 credits |
- Pay as you go is on when you subscribe. The starting limit on Starter is $50 a month, and you can raise it, lower it or turn pay as you go off.
- With pay as you go off, or once the limit is reached, requests return
insufficient_creditsuntil your credits renew or you change the limit. - Pay-as-you-go credits are billed to the card on your plan. On a monthly plan they are added to the next invoice; on a yearly plan they are invoiced each month.
- If you often pass your included credits, the next plan up costs less per credit than pay as you go.
{
"success": false,
"error": {
"code": "insufficient_credits",
"message": "This lookup needs 1 credit and you have 0."
},
"meta": {
"credits_used": 0,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}What is not charged
- Failures. A request that returns an error is never charged, including
source_unavailableandinternal_error. - Misses on match pricing. Products charged per match return
200withcredits_used: 0when nothing is found. - Repeats. The same input within 7 days is served from cache at no charge. Send
fresh: trueto force a new, charged lookup. - Test keys. Keys that start with
1lk_test_return sample responses and never spend credits.
Tracking spend
Every response reports what it cost. meta.credits_used is the charge for that call and meta.credits_remaining is your balance after it, so you can stop or slow a job from your own code.
{
"credits_used": 1,
"credits_remaining": 5999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}Bulk jobs return an estimated_credits figure before they run. The dashboard shows usage by product, and a credits.low webhook fires when your balance falls below the alert threshold you set.