How credits work
Every Encrata workspace has a credit balance. Most enrichment endpoints consume 1 credit per request. Some endpoints are completely free. Credits are deducted after a successful response if a lookup fails (502, 503), you’re not charged.Credit costs
Paid endpoints (1 credit each)
Premium endpoints
Repeat Email Identity lookups of the same address are served from cache with free repeats within the billing window.
Free endpoints (0 credits)
Bulk & monitor runs
Checking your balance
Your current credit balance is visible in the dashboard.Insufficient credits
When you don’t have enough credits, the API returns:402 Payment Required.
Webhook alerts
Set up webhooks to get notified about credit usage:
See Webhooks to configure these alerts.
Tips
Use free endpoints first
Validate emails before enriching skip invalid addresses to save credits.
Select fields
Use the
fields parameter to request only what you need. Reduces response size (same credit cost, but faster).Use monitors for recurring
Instead of manual re-lookups, set up monitors they only charge for actual enrichment runs.
Bulk for volume
Bulk endpoints have the same per-item cost but lower rate limits, making high-volume work easier.