Get Email Address Information API

Description:
This API provides validation information for an email address to aid in email deliverability and to prevent delivery to bad email addresses which can get you placed on spam lists. It also provides additional demographic and descriptive data about the email address that is useful for marketing, segmentation, etc.

Example of email information and validation responses.
Email	Response	Info	IsGovernment	IsEducational	IsGeneric	Geolocation
jimsmith@gmail.com	valid	mail server ok			true
jimsmith@gmail	invalid	invalid syntax
johndoe@yahoo.com.mx	valid	mail server ok			true	Mexico
winston.smith@maths.ox.ac.uk	valid	mail server ok		true	true	United Kingdom
jane.doe@sjfdhsndsd.com	invalid	no mail server
unclesam@irs.gov	valid	mail server ok	true

Integrated Database Email Validation Reports: Use this API to easily append email validation and enrichment data directly to Cloud database tables from a Web browser. The Email Validation and Enrichment SQL is auto-generated to create the reports directly from database tables using this API.

Service API Endpoint:
https://api.interzoid.com/getemailinfo

Calling Structure:
https://api.interzoid.com/getemailinfo?license=[licensekey]&email=[email address]

Optional Specification Examples:
OpenAPI Specification 3.1 JSON

Input Parameters:
License: Your Interzoid-issued license key
Email: Email address to validate and retrieve validation and enrichment info for

Output Parameters:
Response: Validation information for the email address
Info: Additional information about the type of email address and its validation
IsGovernment: Is this identified as a government email address?
IsEducational: Is this identified as an educational email address?
IsOrganizational: Is this identified as an organizational email address?
IsVulgar: Are there recognizable vulgarities present in the email address?
IsGeneric: Is this email address generic (Gmail, Hotmail, Yahoo, etc.), rather than corporate or organizational email?
Geolocation: Location if geographic information is present in the email address

Sample URL Query:
https://api.interzoid.com/getemailinfo?license=dh8dj2f*****&email=jimsmith@gmail.com

Sample JSON Output:
{"Email":"jimsmith@gmail.com","Response":"valid","Info":"mail server ok","IsGovernment":"","IsEducational":"","IsOrganizational":"","IsVulgar":"","IsGeneric":"true","Geolocation":"","Code":"Success","Credits":91686}

You can also set a header value for your API License Key (*recommended for production environments):

Curl Example:
curl --header "x-api-key: dh8dj2f*****" "https://api.interzoid.com/getemailinfo?email=jimsmith@gmail.com"

Sample Code Showing Usage:
Github

Try the API interactively:
(API License Key will auto-populate if you have an account and are logged in. Otherwise, register for a free account.)

Result Code:

Response:

Info:

IsGovernment:

IsEducational:

IsOrganizational:

IsVulgar:

IsGeneric:

IsDisposable:

Geolocation:

Credits Remaining:

See this API in action with our Cloud Data Connect Web application, which uses the API to match entire datasets and database tables. You can run sample datasets without using any API credits.

To automate calls to this API against a targeted data source with a single command, see documentation here.

Do you have custom requirements or are interested in on-premise solutions? Contact us at support@interzoid.com