loading-img

JSON Response format

GEThttps://email-validation-api.com/api/json?key=your_api_key&email=email_address

The 2 variable elements of this URL (email and your_api_key) have to be replaced by some values before performing the request.
A correct URL would be for example:
https://email-validation-api.com/api/json?key=f25a2fc72690b780b2a14e140ef6a9e0&email=jeancharle@hotmail.com

Variables description

Name Description
email *
array[string]
(query)

Specify the Email address to be submitted for verification

key *
array[string]
(query)

Specify your API Key. (It is sent to you by Email when you register)

Response on success

Field name Description
processed

Boolean value
This field determines if the verification has been performed (true), or if an error has occurred (false)

submitted

String value
Reminds you the exact Email address that you have submitted with your request

corrected

String value
In case of a potential typo detected, this field contains the Email address corrected with the domain name actually meant. Note: The verification will then be performed on the corrected version of the Email. If this field is empty, then you can ignore it

username

String value
Returns the local part of the request email address

domain

String value
Returns the domain of the requested email address.

format_valid

Boolean value
Returns true or false depending on whether or not the general syntax of the requested email address is valid.

is_npai

Boolean value
Returns true or false depending on whether or not the email address submitted is known to lead to an error

is_spamtrap

Boolean value
Returns true or false depending on whether or not the email address submitted is known to be a trap designed by ISP companies to detect spammer activities

mx_exist

Boolean value
Returns true or false depending on whether or not MX-Records for the requested domain name could be found.

smtp_exist

Boolean value
Returns true or false depending on whether or not the SMTP check of the requested email address succeeded.

is_catchall

Boolean value
Returns true or false depending on whether or not the requested email address is found to be part of a catch-all mailbox

is_role

Boolean value
Returns true or false depending on whether or not the requested email address is a role email address.

is_disposable

Boolean value
Returns true or false depending on whether or not the requested email address is a disposable email address.

score

Integer value
Returns a numeric score between 0 and 100 reflecting the quality and deliverability of the requested email address.

Response example on success
{"processed":true,"submitted":"jeancharle@hotmail.com","corrected":"","username":"jeancharle","domain":"hotmail.com","format_valid":true,"is_npai":true,"is_spamtrap":false,"mx_exist":true,"smtp_exist":true,"is_catchall":false,"is_role":false,"is_disposable":false,"score":100}

Response on failure

Field name Description
processed

Boolean value
This field determines if the verification has been performed (true), or if an error has occurred (false)

msg

Contains the reason of the failure, basically if your suscription runs out, if you reach limitations on free plan, or if the the request to the API is not well formated.

Response example on failure
{"processed":false,"msg":"The Email submitted is not well formatted, therefore we cannot perform any further verification"}

XML Response format

GEThttps://email-validation-api.com/api/xml?key=your_api_key&email=email_address

The 2 variable elements of this URL (email and your_api_key) have to be replaced by some values before performing the request.
A correct URL would be for example:
https://email-validation-api.com/api/xml?key=f25a2fc72690b780b2a14e140ef6a9e0&email=jeancharle@hotmail.com

Variables description

Name Description
email *
array[string]
(query)

Specify the Email address to be submitted for verification

key *
array[string]
(query)

Specify your API Key. (It is sent to you by Email when you register)

Response on success

Field name Description
processed

Boolean value
This field determines if the verification has been performed (true), or if an error has occurred (false)

submitted

String value
Reminds you the exact Email address that you have submitted with your request

corrected

String value
In case of a potential typo detected, this field contains the Email address corrected with the domain name actually meant. Note: The verification will then be performed on the corrected version of the Email. If this field is empty, then you can ignore it

username

String value
Returns the local part of the request email address

domain

String value
Returns the domain of the requested email address.

format_valid

Boolean value
Returns true or false depending on whether or not the general syntax of the requested email address is valid.

is_npai

Boolean value
Returns true or false depending on whether or not the email address submitted is known to lead to an error

is_spamtrap

Boolean value
Returns true or false depending on whether or not the email address submitted is known to be a trap designed by ISP companies to detect spammer activities

mx_exist

Boolean value
Returns true or false depending on whether or not MX-Records for the requested domain name could be found.

smtp_exist

Boolean value
Returns true or false depending on whether or not the SMTP check of the requested email address succeeded.

is_catchall

Boolean value
Returns true or false depending on whether or not the requested email address is found to be part of a catch-all mailbox

is_role

Boolean value
Returns true or false depending on whether or not the requested email address is a role email address.

is_disposable

Boolean value
Returns true or false depending on whether or not the requested email address is a disposable email address.

score

Integer value
Returns a numeric score between 0 and 100 reflecting the quality and deliverability of the requested email address.

Response example on success
<?xml version="1.0" encoding="UTF-8"?><query><processed><![CDATA[true]]></processed><submitted><![CDATA[jeancharle@hotmail.com]]></submitted><corrected><![CDATA[]]></corrected><username><![CDATA[jeancharle]]></username><domain><![CDATA[hotmail.com]]></domain><format_valid><![CDATA[true]]></format_valid><is_npai><![CDATA[true]]></is_npai><is_spamtrap><![CDATA[false]]></is_spamtrap><mx_exist><![CDATA[true]]></mx_exist><smtp_exist><![CDATA[true]]></smtp_exist><is_catchall><![CDATA[false]]></is_catchall><is_role><![CDATA[false]]></is_role><is_disposable><![CDATA[false]]></is_disposable><score><![CDATA[100]]></score></query>

Response on failure

Field name Description
processed

Boolean value
This field determines if the verification has been performed (true), or if an error has occurred (false)

msg

Contains the reason of the failure, basically if your suscription runs out, if you reach limitations on free plan, or if the the request to the API is not well formated.

Response example on failure
<?xml version="1.0" encoding="UTF-8"?><query><processed><![CDATA[false]]></processed><msg><![CDATA[The Email submitted is not well formatted, therefore we cannot perform any further verification]]></msg></query>

CSV Response format

GEThttps://email-validation-api.com/api/csv?key=your_api_key&email=email_address

The 2 variable elements of this URL (email and your_api_key) have to be replaced by some values before performing the request.
A correct URL would be for example:
https://email-validation-api.com/api/csv?key=f25a2fc72690b780b2a14e140ef6a9e0&email=jeancharle@hotmail.com

Variables description

Name Description
email *
array[string]
(query)

Specify the Email address to be submitted for verification

key *
array[string]
(query)

Specify your API Key. (It is sent to you by Email when you register)

Response on success

Field name Description
processed

Boolean value
This field determines if the verification has been performed (true), or if an error has occurred (false)

submitted

String value
Reminds you the exact Email address that you have submitted with your request

corrected

String value
In case of a potential typo detected, this field contains the Email address corrected with the domain name actually meant. Note: The verification will then be performed on the corrected version of the Email. If this field is empty, then you can ignore it

username

String value
Returns the local part of the request email address

domain

String value
Returns the domain of the requested email address.

format_valid

Boolean value
Returns true or false depending on whether or not the general syntax of the requested email address is valid.

is_npai

Boolean value
Returns true or false depending on whether or not the email address submitted is known to lead to an error

is_spamtrap

Boolean value
Returns true or false depending on whether or not the email address submitted is known to be a trap designed by ISP companies to detect spammer activities

mx_exist

Boolean value
Returns true or false depending on whether or not MX-Records for the requested domain name could be found.

smtp_exist

Boolean value
Returns true or false depending on whether or not the SMTP check of the requested email address succeeded.

is_catchall

Boolean value
Returns true or false depending on whether or not the requested email address is found to be part of a catch-all mailbox

is_role

Boolean value
Returns true or false depending on whether or not the requested email address is a role email address.

is_disposable

Boolean value
Returns true or false depending on whether or not the requested email address is a disposable email address.

score

Integer value
Returns a numeric score between 0 and 100 reflecting the quality and deliverability of the requested email address.

Response example on success
processed,submitted,corrected,username,domain,format_valid,is_npai,is_spamtrap,mx_exist,smtp_exist,is_catchall,is_role,is_disposable,score
1,jeancharle@hotmail.com,,jeancharle,hotmail.com,1,1,0,1,1,0,0,0,100

Response on failure

Field name Description
processed

Boolean value
This field determines if the verification has been performed (true), or if an error has occurred (false)

msg

Contains the reason of the failure, basically if your suscription runs out, if you reach limitations on free plan, or if the the request to the API is not well formated.

Response example on failure
processed,msg
0,The Email submitted is not well formatted therefore we cannot perform any further verification

Serialized PHP Response format

GEThttps://email-validation-api.com/api/serializedphp?key=your_api_key&email=email_address

The 2 variable elements of this URL (email and your_api_key) have to be replaced by some values before performing the request.
A correct URL would be for example:
https://email-validation-api.com/api/serializedphp?key=f25a2fc72690b780b2a14e140ef6a9e0&email=jeancharle@hotmail.com

Variables description

Name Description
email *
array[string]
(query)

Specify the Email address to be submitted for verification

key *
array[string]
(query)

Specify your API Key. (It is sent to you by Email when you register)

Response on success

Field name Description
processed

Boolean value
This field determines if the verification has been performed (true), or if an error has occurred (false)

submitted

String value
Reminds you the exact Email address that you have submitted with your request

corrected

String value
In case of a potential typo detected, this field contains the Email address corrected with the domain name actually meant. Note: The verification will then be performed on the corrected version of the Email. If this field is empty, then you can ignore it

username

String value
Returns the local part of the request email address

domain

String value
Returns the domain of the requested email address.

format_valid

Boolean value
Returns true or false depending on whether or not the general syntax of the requested email address is valid.

is_npai

Boolean value
Returns true or false depending on whether or not the email address submitted is known to lead to an error

is_spamtrap

Boolean value
Returns true or false depending on whether or not the email address submitted is known to be a trap designed by ISP companies to detect spammer activities

mx_exist

Boolean value
Returns true or false depending on whether or not MX-Records for the requested domain name could be found.

smtp_exist

Boolean value
Returns true or false depending on whether or not the SMTP check of the requested email address succeeded.

is_catchall

Boolean value
Returns true or false depending on whether or not the requested email address is found to be part of a catch-all mailbox

is_role

Boolean value
Returns true or false depending on whether or not the requested email address is a role email address.

is_disposable

Boolean value
Returns true or false depending on whether or not the requested email address is a disposable email address.

score

Integer value
Returns a numeric score between 0 and 100 reflecting the quality and deliverability of the requested email address.

Response example on success
a:15:{s:9:"processed";b:1;s:9:"submitted";s:22:"jeancharle@hotmail.com";s:9:"corrected";s:0:"";s:8:"username";s:10:"jeancharle";s:6:"domain";s:11:"hotmail.com";s:12:"format_valid";b:1;s:7:"is_npai";b:0;s:11:"is_spamtrap";b:0;s:8:"mx_exist";b:1;s:10:"smtp_exist";b:1;s:10:"smtp_hosts";a:1:{s:21:"smtp-mail.outlook.com";a:1:{i:0;i:587;}}s:11:"is_catchall";b:0;s:7:"is_role";b:0;s:13:"is_disposable";b:0;s:5:"score";i:100;}

Response on failure

Field name Description
processed

Boolean value
This field determines if the verification has been performed (true), or if an error has occurred (false)

msg

Contains the reason of the failure, basically if your suscription runs out, if you reach limitations on free plan, or if the the request to the API is not well formated.

Response example on failure
a:2:{s:9:"processed";b:0;s:3:"msg";s:95:"The Email submitted is not well formatted, therefore we cannot perform any further verification";}