# Email Validation API New!

The JSON API provides capability to verify your customers email addresses.

It supports CORS and can return data as JSON or JSONP.

Before creating a custom integration, please check our list of Data Validation Plugins. You might find something suitable for your platform there.

We also have a JavaScript library which implements a simple interface for forms and only takes a few minutes to integrate.

# Request

https://api.craftyclicks.co.uk/email/1.0/validate

The service accepts POST / GET requests.

# Parameters

Key Type Required? Description
key string Required Your unique access token.
email string Required The email address you wish to verify.
{
	"key":"<<your access token>>",
	"email": "email_to@test.com"
}

# Response

Key Type Description
result boolean If the result is TRUE, the queried email address is valid.
email string The email address you've queried
reason string If risk is not low or if the result is false, this field provides a technical reason.
is_disposable_address boolean If TRUE, the email address is from a disposable email service.
is_role_address boolean If TRUE, the email username indicates that this is a generic role username. (admin, sales, support, etc.),
risk string 'low', 'medium', 'high': gives a combined risk rating based on the other fields in the result.
{
    "result": true,
    "email": "support@codewerk.co.uk",
    "reason": "mailbox_is_role_address",
    "is_disposable_address": false,
    "is_role_address": true,
    "risk": "medium"
}
Last Updated: 7/13/2020, 9:40:52 AM