Email check

Check an address before you accept a signup: syntax, throwaway domains, mail servers, typos and role mailboxes.

Check an email address

POST/v1/email/check

API key1 request

Parameters

emailstringRequired
The address to check, at most 320 bytes. GET takes it as ?email=.

Response fields

emailstring
The address as checked, domain lowercased.
statusstring
valid, invalid, risky or unknown.
reasonstring | null
Why: syntax, no_mx, null_mx, disposable, typo, role, dns_error or quota. null when valid.
suggestionstring | null
The address with the webmail domain fixed, when the domain looks like a typo of one.
domainstring
The domain in ASCII (IDN converted).
checksobject
Each check behind the status.
checks.mxboolean | null
The domain receives mail. null when DNS was not asked or did not answer.
checks.disposableboolean
The domain hands out throwaway inboxes.
checks.roleboolean
A shared mailbox such as info@ or support@.
checks.freeProviderboolean
A free webmail provider such as Gmail or Outlook.
mailboxstring
Always not_checked: the mailbox itself is not probed.

curl -X POST https://ipscanner.io/v1/email/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@outlok.com"}'

Response

{
  "email": "jane@outlok.com",
  "status": "risky",
  "reason": "typo",
  "suggestion": "jane@outlook.com",
  "domain": "outlok.com",
  "checks": {
    "syntax": true,
    "mx": true,
    "disposable": false,
    "role": false,
    "freeProvider": false
  },
  "mailbox": "not_checked"
}