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
| Operation | Cost | Charged When |
|---|---|---|
| Search Records | Free | — |
| Unlock Email | 1 credit | Per record, on unlock |
| Unlock Phone | 5 credits | Per record with phone data |
| Unlock Phone — no data | 1 credit | Per record with no phone data on file |
| Email Enrichment | 1 credit | Only when email is found (status: success) |
| Phone Enrichment | 5 credits | Only 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 Validation | 1 credit per email (default) | Upfront on upload; refunded for any non-Valid result |
| Career Monitor — Lite | 3 credits per record | Deducted on job completion; balance pre-checked at submit |
| Career Monitor — Full | 5 credits per record (adds new company, new title and a verified new-company email) | Deducted on job completion; balance pre-checked at submit |
| Data Enrichment | Per row, sum of selected layers — 6 (L1), 1 (L2), 1 (L3), 2 (L4), 5 (MPA). See Data Enrichment Layer Rates | Held upfront on submit; billed for enriched rows only, skipped/failed rows refunded |
| Email Generation | 5 credits per contact | Charged upfront on upload; refunded for any contact with no email found |
| Already-owned records (any unlock) | 0 credits | Skipped 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_foundresult returns200 OKbut 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 Requiredis 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:
| Level | Without mobile phone | With mobile phone |
|---|---|---|
| Standard | 2 credits/row | 5 credits/row |
| Pro | 10 credits/row | 13 credits/row |
- "With mobile phone" applies when a phone field (
contact_mobile_phoneorcontact_direct_phone) is infields_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:
| Tier | Credits per record | What you get |
|---|---|---|
Lite (lite, default) | 3 | Identity, current title, matched company and employment status |
Full (full) | 5 | Everything 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:
| Layer | Credits per row |
|---|---|
L1 — Career Monitor | 6 |
L2 — Company Location | 1 |
L3 — New Company | 1 |
L4 — New Company Location | 2 |
MPA — Mobile Phone Append | 5 |
Common selections:
selected_layers | Credits per row | 1,000 rows |
|---|---|---|
["L1"] | 6 | 6,000 |
["L1", "L2"] | 7 | 7,000 |
["L1", "L2", "L3"] | 8 | 8,000 |
["L1", "L2", "L3", "L4"] | 10 | 10,000 |
"full" (all four layers + MPA) | 15 | 15,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/, andPOST /estimate/prices a job before you submit it.
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.