v1

latestSwagger 2.02026-07-132830204.5 KB

Data Tools

Email Validate

Parse, validate and clean an email address

get/email-validate

Query parameters

emailstring required

An email address

fix-typosboolean

Automatically attempt to fix typos in the address

Response

validboolean required

Is this a valid email address. To be valid an email must have: correct syntax, a registered and active domain name, correct DNS records and operational MX servers

syntax-errorboolean required

True if this address has any syntax errors or is not in RFC compliant formatting

domainstring required

The domain name of this email address

domain-errorboolean required

True if this address has any domain name or DNS related errors. Check the 'domain-status' field for the detailed error reason

is-freemailboolean required

True if this address is from a free email provider

emailstring required

The complete email address. If you enabled the 'fix-typos' option then this will be the corrected address

is-disposableboolean required

True if this address is a disposable, temporary or darknet related email address

typos-fixedboolean required

True if any typos have been fixed. The 'fix-typos' option must be enabled for this to work

is-personalboolean required

True if this address likely belongs to a person. False if this is a role based address, e.g. admin@, help@, office@, etc.

providerstring required

The domain name of the email hosting provider

mx-ipstring required

The first resolved IP address of the primary MX server, may be empty if there are domain errors present

domain-statusstring required

The email domain status, possible values are: <br> <ul> <li>ok - the domain is in working order and can receive email</li> <li>invalid - the domain is not a conformant hostname. May contain invalid syntax or characters</li> <li>no-service - the domain owner has indicated there is no mail service on the domain (also known as the 'Null MX')</li> <li>no-mail - the domain has no valid MX records so cannot receive email</li> <li>mx-invalid - MX records contain invalid or non-conformant hostname values</li> <li>mx-bogon - MX records point to bogon IP addresses</li> <li>resolv-error - MX records do not resolve to any valid IP addresses</li> </ul>

Example response

{
  "domain": "neutrinoapi.com",
  "domain-error": false,
  "domain-status": "ok",
  "email": "tech@neutrinoapi.com",
  "is-disposable": false,
  "is-freemail": false,
  "is-personal": false,
  "mx-ip": "111.65.230.108",
  "provider": "isx.net.nz",
  "syntax-error": false,
  "typos-fixed": false,
  "valid": true
}