Skip to main content

Credit Costs

Every billable operation in the eCore API is priced in credits drawn from your wallet. This page is the single source of truth for what each operation costs and when the charge is applied.

Pricing Table​

OperationCostCharged When
Search RecordsFree—
Unlock Email1 creditPer record, on unlock
Unlock Phone5 creditsPer record with phone data
Unlock Phone — no data1 creditPer record with no phone data on file
Email Enrichment1 creditOnly when email is found (status: success)
Phone Enrichment5 creditsOnly when phone is found (status: success)
Account/Contact Enrichment (Standard)2 credits/row (5 with mobile phone)Upfront on submit; reconciled at end of job
Account/Contact Enrichment (Pro)10 credits/row (13 with mobile phone)Upfront on submit; reconciled at end of job
Email Validation1 credit per email (default)Upfront on upload; refunded for any non-Valid result
Career Monitor — Lite3 credits per recordDeducted on job completion; balance pre-checked at submit
Career Monitor — Full5 credits per record (adds new company, new title and a verified new-company email)Deducted on job completion; balance pre-checked at submit
Data EnrichmentPer row, sum of selected layers — 6 (L1), 1 (L2), 1 (L3), 2 (L4), 5 (MPA). See Data Enrichment Layer RatesHeld upfront on submit; billed for enriched rows only, skipped/failed rows refunded
Email Generation5 credits per contactCharged upfront on upload; refunded for any contact with no email found
Already-owned records (any unlock)0 creditsSkipped automatically

Charging Behavior​

Charge-on-success (Enrichment endpoints)​

Email and Phone Enrichment use a charge-on-success model:

  • A successful lookup (status: success) deducts the per-call rate.
  • A not_found result returns 200 OK but no credit is charged.
  • Validation errors (400) and auth errors (401) never charge.

This makes enrichment safe to retry with different identifier combinations — only paid hits cost you credits.

Upfront-with-refund (Email Validation, Account Enrichment, Data Enrichment)​

Bulk operations use an upfront-with-refund model:

  • The full estimated cost is deducted before the async worker starts processing.
  • At the end of the job, credits for any record that did not produce a billable outcome (e.g., non-Valid emails, contacts that fail name-match) are refunded in a single combined wallet transaction.
  • If the job crashes, all upfront credits are refunded by the failure handler.

The job's total_credits_charged field shows the final net charge after refunds.

Pre-check before charging​

For every endpoint that charges credits, the wallet balance is checked before the operation begins:

  • Sufficient balance → request proceeds and credits are deducted.
  • Insufficient balance → 402 Payment Required is returned and no credits are deducted.

Per-row Enrichment Rates​

Account & Contact Enrichment is priced per row. The rate depends on the enrichment level and whether a mobile phone number is requested:

LevelWithout mobile phoneWith mobile phone
Standard2 credits/row5 credits/row
Pro10 credits/row13 credits/row
  • "With mobile phone" applies when a phone field (contact_mobile_phone or contact_direct_phone) is in fields_to_enrich.
  • No additional charge when no mobile phone is found — the phone premium is reconciled (reversed) for rows where no number is returned, so you effectively pay the "without mobile phone" rate for those rows.
  • Pro adds AI-driven processing and validation on top of Standard sources to improve data quality and fulfillment rates.
  • Account enrichment does not accept the Pro level and never includes a mobile-phone premium, so it is billed at the Standard "without mobile phone" rate.

How the per-row rate is chosen, and how criteria.limit multiplies the total, is documented under Credit Pricing & Estimation.

Career Monitor Rates​

Career Monitor is priced per record, at the rate of the tier chosen on Submit:

TierCredits per recordWhat you get
Lite (lite, default)3Identity, current title, matched company and employment status
Full (full)5Everything in Lite, plus the new company, new title and a generated + verified email at the new company

For example, 1,000 records at Full cost 5,000 credits. The balance is checked at submit and credits are deducted when the job completes.

Data Enrichment Layer Rates​

Data Enrichment is priced per row. The row price is the sum of the layers you select:

LayerCredits per row
L1 — Career Monitor6
L2 — Company Location1
L3 — New Company1
L4 — New Company Location2
MPA — Mobile Phone Append5

Common selections:

selected_layersCredits per row1,000 rows
["L1"]66,000
["L1", "L2"]77,000
["L1", "L2", "L3"]88,000
["L1", "L2", "L3", "L4"]1010,000
"full" (all four layers + MPA)1515,000
  • Add 5 credits per row to any selection when you include MPA.
  • Credits for the full row count are held at submit. When the job finishes you are charged only for rows that were enriched (status: enriched); skipped and failed rows are refunded. Cancelling releases the whole hold.
  • The live rates for your account are returned by GET /layers/, and POST /estimate/ prices a job before you submit it.
L1 vs Career Monitor

L1 runs the same employment check as Career Monitor. If the employment check is all you need, Career Monitor Lite is cheaper at 3 credits per record (vs 6 for L1).

Pricing Configuration​

The rates on this page are the platform's published defaults. They are read from a pricing configuration that administrators can adjust; when a rate changes, this page is updated. Your remaining_credits (or wallet_balance) field on each response always reflects the canonical balance after the call, so you can reconcile any charge against it.

You do not need to probe the API to discover the current rate — model your costs against the tables on this page. Before a large submission, the Enrichment Submit response returns an estimated_credits value up front, and Data Enrichment's POST /estimate/ prices a job before you submit it, so you can confirm the total cost before the job runs.

Wallet Top-up​

To add credits, sign in to the eCore dashboard at app.ecoreservice.com and open the Subscription & Credit Package tab.