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	DomainOwner
jimsmith@gmail.com	valid	mail server ok			true		Google
jimsmith@gmail	invalid	invalid syntax					Google
johndoe@yahoo.com.mx	valid	mail server ok			true	Mexico	Verizon Media
winston.smith@maths.ox.ac.uk	valid	mail server ok		true		United Kingdom	University of Oxford
jane.doe@sjfdhsndsd.com	invalid	no mail server
unclesam@irs.gov	valid	mail server ok	true			United States	Internal Revenue Service

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]

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
DomainOwner: Company or organization owning the domain

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":"","DomainOwner":"Google LLC","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:

DomainOwner:

Credits Remaining:

To use this API to validate the email addresses within an entire CSV file stored in AWS S3, check out this cURL sample API call using our Cloud Data Connect product:
curl "https://connect.interzoid.com/run?function=emailval&apikey=no-key-needed-for-demo-file&source=CSV&connection=https://dl.interzoid.com/csv/emails.csv&table=CSV&column=1"

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

Do you have custom requirements? We can help. Contact us at support@interzoid.com