Documentation Index
Fetch the complete documentation index at: https://docs.encrata.com/llms.txt
Use this file to discover all available pages before exploring further.
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)
| Endpoint | Description |
|---|---|
/api/agent/lookup | Full email enrichment |
/api/agent/google | Google search |
/api/agent/company | Company intelligence |
/api/agent/domain | Domain WHOIS + knowledge graph |
/api/agent/ip | IP geolocation + threat data |
/api/agent/darkweb | Dark web search (1 credit per 100 results) |
Free endpoints (0 credits)
| Endpoint | Description |
|---|---|
/api/agent/validate | Email deliverability check |
/api/agent/breaches | Breach history lookup |
GET /api/agent/monitors | List/get monitors |
POST /api/agent/monitors | Create monitor |
GET /api/agent/monitoring/runs | List runs |
GET /api/agent/monitoring/results | List results |
GET /api/agent/lists | List contact lists |
GET/POST /api/webhooks | Webhook management |
GET /api/health | Health check |
Bulk & monitor runs
| Operation | Cost |
|---|---|
| Bulk lookup (up to 1000 emails) | 1 credit per successful enrichment |
| Monitor run trigger | 1 credit per target in the monitor |
Dark web search charges 1 credit per 100-result page. A search returning 250 results costs 3 credits (pages 0–99, 100–199, 200–249).
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:| Event | Trigger |
|---|---|
credits.low | Credits drop below your configured threshold |
credits.exhausted | Credits reach zero |
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.