Understanding Credits
How credits work, what costs what, and how to monitor your usage.
Credits are the currency of the Enrich Layer API. Every API call costs a certain number of credits depending on the endpoint and whether the result is cached.
Credit costs by endpoint
| Endpoint | Credits | Notes |
|---|---|---|
| Person Profile | 1 | Most common endpoint |
| Reverse Email Lookup | 3 | Email-to-profile resolution |
| Company Profile | 1 | Company enrichment |
| Person Search | 3 | Per profile result |
| Company Search | 3 | Per profile result |
| Personal Email Lookup | 1 | Per email |
| Personal Contact Number Lookup | 1 | Per contact number |
| Disposable Email Check | 0 | Free |
| Credit Balance Check | 0 | Free |
When are credits charged?
- Successful lookup — Credits are charged when the API returns data (2xx response)
- Cache hit — No additional credits if the result is already cached within your plan's cache window
- Not found (404) — No credits charged
- Error (5xx) — No credits charged
Checking your balance
Use the Meta API to check your remaining credits:
curl -H "Authorization: Bearer YOUR_API_KEY" \
'https://enrichlayer.com/api/v2/credit-balance'bash
You can also view usage history in your dashboard.
Running low on credits?
- Top up — Purchase additional credits from the pricing page
- Upgrade your plan — Higher plans include more credits at a lower per-credit cost
- Optimize usage — Use caching (
use_cache=if-present) to avoid redundant lookups