Skip to main content

​
Endpoint

POST /v1/email
Cost: 1 credit per request

​
Request body

{
  "email": "hello@datalinkapis.com"
}
FieldTypeRequiredDescription
emailstringYesThe email address to validate

​
Example request

curl -X POST https://api.datalinkapis.com/v1/email \
  -H "Authorization: Bearer dl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "hello@datalinkapis.com" }'

​
Response

{
  "email": "hello@datalinkapis.com",
  "valid": true,
  "deliverable": true,
  "syntax_valid": true,
  "mx_found": true,
  "smtp_valid": true,
  "disposable": false,
  "role_account": false,
  "free_provider": false,
  "domain": "datalinkapis.com",
  "credits_used": 1
}

​
Response fields

FieldTypeDescription
emailstringThe email address that was checked
validbooleanOverall validity — true if the address is likely deliverable
deliverablebooleanWhether SMTP handshake confirmed the mailbox exists
syntax_validbooleanWhether the address passes RFC 5321 syntax rules
mx_foundbooleanWhether a valid MX record exists for the domain
smtp_validbooleanWhether the SMTP server accepted the address
disposablebooleanWhether the domain belongs to a disposable/temporary email provider
role_accountbooleanWhether this is a role address (e.g. info@, support@, noreply@)
free_providerbooleanWhether this is a free consumer email provider (e.g. Gmail, Yahoo)
domainstringThe domain portion of the email address
credits_usedintegerCredits deducted — always 1 for this endpoint

​
Use cases

  • List hygiene — remove invalid and undeliverable addresses before a send
  • Signup validation — reject disposable addresses at the point of registration
  • Role account filtering — flag addresses unlikely to belong to a real person