Email Verification API

Build
Send
Response
Errors

The email verification API is currently in alpha and not ready for production use. The API can change at any time without prior warning. Please get in touch with us if you are interested in knowing more about the email verification features and how you can take advantage of them.

This page contains the technical information for our Email Verification API. Please visit our email verification demo page if you are looking to see it in practice.

The Email Verification API takes an email address (potentially containing spelling mistakes and/or other errors) and validates the syntax, the existence and availability of the domain, the existence of the email account, and returns a verified state and other metadata.

Build the request URL

Use the form below to build your request URL from the available parameters. The URL string will be generated and can be sent to the API in order to provide insight into how the API works and the response it returns. Or, if you are using Postman for your investigation, development and testing, include the desired parameters and copy and paste the request URL below into Postman's GET request URL field.

Field Name	Value	Type	Description
key *		String	Your unique licence key (find on Portal credentials).
secret *		String	Your unique secret key (find on Portal credentials). Alternatively, you can pass your secret key into the Authorization header of the request as such: `Authorization: your-secret`
email *		String	The email to be verified.
format		String	The format of the response.
	Options json `json` for a response in json format. xml `xml` for a response in xml format.
domain		String	Used to identify which of your services is calling the API for activity monitoring purposes. This domain needs to be registered in the portal. Learn more.

* Parameters marked with an asterisk are mandatory for this API call.

Request URL

https://api.addressfinder.io/api/email/v1/verification/

      
        /* Click the button above to see a real API response here */
        {
          "success": true
        }

Response Specification

The API response will include all the attributes associated with the email address in the format requested in the API request.

Field Name	Type	Description	Example
`success`	Boolean	Indicates if the request was successful or not.	true
`account`	String	The first part of an email address, before the `@`	jane.smith
`email_domain`	String	The second part of the email address, after the `@`	addressfinder.com
`is_verified`	Boolean	We did not find any reason to believe an email sent to the address provided would fail to reach the associated mailbox.	true
`is_connectable`	Boolean	Indicates if we were able to establish a successful connection to the email server. This indicates the highest level of certainty about the email server.	true
`is_disposable`	Boolean	Identified as a disposable email address. Learn more.	false
`is_role`	Boolean	The email account is for a group email. For example info@addressfinder.com.	false
`is_public`	Boolean	Identified as a public email provider. For example jane.smith@gmail.com.	false
`not_verified_reason`	String	If verified is false, this will contain a short description of the failure reason.	The email format is incorrect
`not_verified_code`	String	A code indicating why the email did not verify.	`FORMAT_INVALID`

Errors

Below are the possible errors that can be returned by the API.