Credits

Every Encrata account has a credit balance. Lookups use fixed, outcome-based, or free pricing. You are only charged on a successful response.

Credits are deducted after a successful response. If a lookup fails with a 5xx error, you are not charged.

How billing works

Free-repeat window

Repeat lookups of the same input are free for 6 months after your first paid lookup.

Pay on success

Failed lookups (502, 503, 504) never cost credits.

Free repeats

Most 1-credit lookups are free again for the same address during the 6-month free-repeat window.

Outcome-based

GitHub Leaks and Exposed API Keys charge only when they find credentials.

What each lookup costs

Standard (1 credit)
Premium
Outcome-based
Free

Endpoint	What it does
`/api/lookup/email/validity`	Email deliverability check
`/api/lookup/email/gender`	Predict gender and country
`/api/lookup/email/compliance`	Resolve cold-email jurisdiction and rule
`/api/lookup/email/breaches`	Breach history for an email
`/api/lookup/email/password/breaches`	Check if a password has leaked
`/api/lookup/malware/scan`	Scan one URL, QR code, barcode, image, or file

Repeat lookups of the same input during the 6-month free-repeat window are free (credits: 0, served from cache).

Endpoint	What it does	Cost
`/api/lookup/email/identity`	Resolve the person behind an email: name, role, company, socials	1,000 credits

Repeat Email Identity lookups of the same address are served from cache as free repeats during the 6-month free-repeat window.

Endpoint	What it does	Cost
`/api/lookup/breaches/github`	Scan a public repo for leaked secrets	1 credit per leak found
`/api/lookup/breaches/exposed-keys`	Scan collected text for exposed credentials	1 credit per credential found

Clean scans are free. Reused GitHub and exposed-key scans do not charge an account twice for the same stored result.

Endpoint	What it does
`GET/POST /api/webhooks`	Webhook management
`GET /api/health`	Health check

Bulk runs

Bulk runs charge per successful item, not per request. A run of many addresses charges only for the ones that resolve successfully.

Operation	Cost
Bulk lookup (up to 1,000,000 emails)	The lookup’s normal rate per row. Email Identity costs 1,000 credits per row.

Check your balance

Check it in the dashboard, or read it programmatically to gate spend in your own code.

API
Dashboard

Call GET /api/account/credits:

curl https://developer.encrata.com/api/account/credits \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "credits_remaining": 4794,
  "credits_used": 206,
  "total_lookups": 206,
  "stats_degraded": false
}

When you run out

When your balance is too low for a lookup, the API rejects the request with 402 Payment Required and does not run the lookup.

{
  "error": "Insufficient credits"
}

Get notified before you run out

Set up webhooks to catch low balances before they block a lookup.

credits.low

Fires when your balance drops below the threshold you configure.

credits.exhausted

Fires when your balance reaches zero.

See Webhooks to configure these alerts.

Tips to spend less

Validate before you enrich

Run the free-repeat validity check first and skip invalid addresses before a premium lookup.

Batch high-volume work

Bulk runs share the same per-item cost but are built for volume.

Reuse recent lookups

Repeat lookups during the 6-month free-repeat window are free. Cache results on your side to avoid unnecessary calls.

Overview

Configuration

Best practices

How billing works

Free-repeat window

Pay on success

Free repeats

Outcome-based

What each lookup costs

Bulk runs

Check your balance

When you run out

Get notified before you run out

Tips to spend less

Validate before you enrich

Batch high-volume work

Reuse recent lookups

Next steps

Quickstart

Rate limits

​How billing works

​Free-repeat window

Pay on success

Free repeats

Outcome-based

​What each lookup costs

​Bulk runs

​Check your balance

​When you run out

​Get notified before you run out

​Tips to spend less

Validate before you enrich

Batch high-volume work

Reuse recent lookups

​Next steps

Quickstart

Rate limits

How billing works

Free-repeat window

What each lookup costs

Bulk runs

Check your balance

When you run out

Get notified before you run out

Tips to spend less

Next steps