Skip to main content
POST
/
api
/
agent
/
validate
Validate Email
curl --request POST \
  --url https://encrata.com/api/agent/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>"
}
'
{
  "email": "<string>",
  "validity": "<string>",
  "message": "<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

​
email
string
required
The email address to validate.

​
Example request

curl -X POST "https://encrata.com/api/agent/validate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

​
Response

​
email
string
The email address that was validated.
​
validity
string
One of valid, invalid, disposable, or unknown.
​
message
string
Human-readable explanation of the result.

​
Example responses

Valid email
{
  "email": "satya@microsoft.com",
  "validity": "valid",
  "message": "Email is deliverable and valid."
}
Disposable email
{
  "email": "user@tempmail.com",
  "validity": "disposable",
  "message": "This is a disposable/temporary email address."
}
Invalid email
{
  "email": "nobody@nonexistent.xyz",
  "validity": "invalid",
  "message": "Email is not deliverable or does not exist."
}

​
Notes

  • This endpoint is free — no credits are deducted.
  • Disposable email detection runs first; if the domain is disposable, the SMTP check is skipped.
  • Rate limited to 60 requests per minute.