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	5 credits per record (default)	Deducted on job completion; balance pre-checked at submit
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_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)

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:

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_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.

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, 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.