Email verification API

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.

Endpoint

Global

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

Parameters

Parameter	Description	Test Value
`key`	Your unique licence key (find on Portal credentials) Type: `string` `required`
`secret`	Your unique secret key from Portal Credentials. You can also pass your secret key into the `Authorization` header of the request. Only required for server-to-server calls. Type: `string`
`format`	The required format of the response. Default value: `json` Type: `string`
`email`	The email to be verified. Type: `string`
`domain`	Used to identify which of your services is calling the API for activity monitoring purposes. This domain needs to be registered in the portal. Type: `string`
`features`	A comma-separated list of parameters that controls the methods of verification to be completed. This will impact the query processing time and data returned in the response. Options: `domain` checks if the domain is configured to receive emails; `connection` checks if the email account exists; `provider` checks and returns the email service provider. Default value: `domain,connection` Type: `string`

Responses

200 OK

Name	Description	Example
`email_account`	The first part of an email address, before the `@` Type: `string`	john.doe
`email_domain`	The second part of the email address, after the `@` Type: `string`	addressfinder.com
`email_provider_domain`	The underlying provider of the email service. Only populated if the features=provider parameter is provided. Type: `string`	google.com
`verified_email`	The full verified email address Type: `string`	jane.smith@addressfinder.com
`is_verified`	We did not find any reason to believe an email sent to the address provided would fail to reach the associated mailbox Type: `boolean`	true
`is_disposable`	Identified as a disposable email address Type: `boolean`	false
`is_role`	The email account is for a group email. For example info@addressfinder.com Type: `boolean`	false
`is_public`	Identified as a public email provider. For example john.doe@gmail.com Type: `boolean`	false
`is_catch_all`	The email domain has a catch all policy Type: `boolean`	false
`not_verified_reason`	If verified is false, this will contain a short description of the failure reason Type: `string`	-
`not_verified_code`	A code indicating why the email did not verify Type: `string`	-
`success`	Indicates if the request was successful or not Type: `boolean`	true

400 Bad request

Name	Description	Example
`completions`	An empty array will be returned due to the error Type: `array`	-
`error_code`	A unique numerical value identifying the error that occured Type: `string`	1004
`message`	An informative message describing the error that occured Type: `string`	Secret not provided
`success`	Indicates if the request was successful or not Type: `boolean`	false

See API Error Reference for details.