Skip to main content

Email metadata

The email verification service returns useful information about each email address. This information maybe captured and used for important downstream purposes.

Metadata returned

NameTypeExampleDescription
successBooleantrueReturns true if the service ran successfully*
verified_emailStringemail@example.comThe full verified email address
email_accountStringemailThe first part of the email address
email_domainStringexample.comThe second part of the email address
is_verifiedBooleantrueThe address is valid and verified
is_disposableBooleantrueThe address is disposable
is_roleBooleantrueThe address is a group email (e.g. support@addressfinder.com)
is_publicBooleantrueThe email provider is public (e.g. Gmail, Yahoo, etc.)
is_catch_allBooleantrueThe email domain has a catch-all policy
not_verified_reasonStringThe email format is incorrectA short description of why is_verified is false
not_verified_codeStringFORMAT_INVALIDError code if is_verified is false
email_provider_domainStringgoogle.comThe base domain of the email provider

*The success response only indicates if the verification process ran successfully regardless of if the email address is valid or not.

Collecting email metadata

The widget can be configured to collect the above metadata from the Email Verification API response.

View this code example demonstrating the EV widget's ability to collect and store the returned metadata. In this example, the widget is making use of the result:verified and result:not_verified events.

Review the constructor, methods, options and events documented in the Javascript Reference page.