Email Validation API

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	✔️	Your unique access token.
`email`	string	✔️	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"
}