Email Verification API

Build
Send
Response
Errors

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 GET 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`. FAQ: Learn more about authenticating direct API calls in request headers
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.
features		String	A parameter that controls the methods of verification to be completed. This will impact the query processing time and data returned in the response. Use a comma to seperate multiple values. Default is domain,connection.
	Options Domain `domain` A check to verify that the domain of the email address is configured to receive emails. Connection `connection` A check to verify that the email account exists at the provided domain. Email provider `provider` A check that determines the underlaying provider of the email service.

* 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
`verified_email`	String	The full verified email address.	jane.smith@addressfinder.com
`email_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_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
`is_catch_all`	Boolean	The email domain has a catch all policy. Learn more.	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`
`email_provider_domain`	String	The underlying provider of the email service. Only populated if the `features=provider` parameter is provided.	google.com

Errors

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