Skip to main content

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.

Base URL

https://encrata.com

Endpoints

MethodPathDescriptionAuth
POST/api/agent/lookupFull email lookupAPI Key
POST/api/agent/validateEmail deliverability check (free)API Key
POST/api/agent/breachesData breach check (free)API Key
POST/api/agent/ipIP intelligenceAPI Key
POST/api/agent/companyCompany searchAPI Key
POST/api/agent/domainDomain searchAPI Key
POST/api/agent/darkwebDark web searchAPI Key
POST/api/agent/googleGoogle searchAPI Key
GET/api/agent/monitorsList monitorsAPI Key
POST/api/agent/monitorsCreate monitorAPI Key
GET/api/agent/monitors/{id}Get monitorAPI Key
DELETE/api/agent/monitors/{id}Delete monitorAPI Key
POST/api/agent/monitors/{id}/runTrigger monitor runAPI Key
GET/api/agent/monitoring/runsList all runsAPI Key
GET/api/agent/monitoring/resultsList all resultsAPI Key
GET/api/agent/listsList contact listsAPI Key
GET/api/agent/lists/{id}Get contact listAPI Key
POST/mcpMCP server (Model Context Protocol)API Key
GET/api/healthHealth checkNone

Rate limits

EndpointLimitWindow
/api/agent/lookup60 requests1 minute
/api/agent/validate60 requests1 minute
/api/agent/breaches60 requests1 minute
/api/agent/ip60 requests1 minute
/api/agent/domain30 requests1 minute
/api/agent/company30 requests1 minute
/api/agent/google30 requests1 minute
/api/agent/darkweb30 requests1 minute
/api/agent/monitors60 requests1 minute
/api/webhooks/*30 requests1 minute
When rate limited, the API returns 429 Too Many Requests with these headers:
HeaderDescription
X-RateLimit-LimitMaximum requests allowed in the window
X-RateLimit-RemainingRequests remaining in current window
X-RateLimit-ResetUnix timestamp when the window resets
Retry-AfterSeconds to wait before retrying (only on 429)

Response format

All endpoints return JSON. The agent endpoint uses compact single-letter keys to minimize token usage when consumed by AI agents.

Standard errors

{
  "error": "Invalid email address"
}

Agent errors

{
  "c": 400,
  "m": "bad email"
}

Credits

ScenarioCost
Fresh lookup1 credit
Cached lookup (within 24h)0 credits

Data pipeline

Each lookup runs multiple enrichment services in parallel for minimal latency:
Email Input
├── Profile Enrichment    → Identity, company, education, skills
├── Web Intelligence      → News, scholar, patents, videos, social links
├── Breach Detection      → Data breach history
├── Email Verification    → Deliverability check
└── Disposable Detection  → Throwaway email check

→ Merge & deduplicate results
→ Cache in database
→ Return enriched PersonInfo