Skip to main content
POST
/
api
/
agent
/
bulk-lookup
Bulk Lookup
curl --request POST \
  --url https://encrata.com/api/agent/bulk-lookup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "emails": [
    "<string>"
  ]
}
'

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.

Authentication

Requires an API key in the Authorization header.
Authorization: Bearer YOUR_API_KEY

Request

emails
string[]
required
Array of email addresses to enrich (max 1,000).

Example request

curl -X POST "https://encrata.com/api/bulk-lookup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "emails": ["alice@company.com", "bob@startup.io", "jane@corp.co"] }'

Response

Results are streamed via Server-Sent Events (SSE). Each enriched record is sent as a separate event.
data: {"email":"alice@company.com","name":"Alice Smith","company":"Acme Inc",...}

data: {"email":"bob@startup.io","name":"Bob Jones","company":"Startup IO",...}

data: [DONE]

Credits

Each successfully enriched email consumes 1 credit. Invalid or unresolvable emails do not consume credits.

Rate Limits

Maximum 1,000 emails per request. For larger volumes, use Async Bulk Jobs.