Batch Email Verification API

Our Batch Email Verification Real-Time API is a simple JSON based REST Web Service that allows developers to verify their mailing lists with ease. You can program the applications and services you already use to periodically verify and validate your mailing lists all in bulk. This is perfect for bulk email verification as our batch email verification API allows you to verify up to 10 files at a time.

Looking for something else?

Form Validation API | Email Verification API


It is a simple HTTP POST request with these parameters:

source_file: the file containing email addresses that you want to verify (accepts CSV or TXT)
user_API_token: your email verifier account's API Token
free_email: True | False
disposable: True | False
typo_suggest: True | False
role_address: True | False
bad_address: True | False

You would need to input your API key for your Email Verifier App account into the verification request you are making.

Optional Inputs

free_email: to find out if the email belongs to free email service providers
disposable: to find out if the email belongs to temporary email service providers
typo_suggest: to identify any typos in the email address being queried
role_address: to identify if the email is a role-based email
bad_address: to identify if the email is likely to be a spam-trap or complain

API Endpoint:

Body Parameters:

user_API_token = [Your-API-Token]

Note: You can upload up to 10 files at a time using sequential attributes (Eg. source_file1, source_file2, source_file3…)

Return Values:
status – Tells you the status of the uploaded list for processing
original_file_name – Tells you the original file name of the uploaded list
uploaded_jobs – Tells you the number of jobs that have been successfully uploaded
job_id – Tells you the randomly assigned job ID for each list you uploaded
new_file_name – Tells you the randomly assigned file name for the list you uploaded

Example JSON Response:

 "status": "Success",
 "original_file_name": "my-mailing-list.csv",
 "uploaded_jobs": 1,
 "job_id": 001,
 "new_file_name": "EmailsFile/my-mailing-list.csv"

Looking for batch process API Sample Codes? You should be able to find all major language sample codes including C, cURL, C#, GO, Java, Javascript, NodeJS, Objective-C, PHP, Python, Ruby, Shell and more.

Can’t find your API Token? See this article – Where can I find API Token? If you are running out of credit and need more credit for your API transactions, please refer to the article on adding API credit to your account.

Note: “user_API_token” is case sensitive. So API is really uppercase and the rest of it is lower case. Failure to do this might result in an error. In addition to this, you MUST have enough API credit to use this API. You can convert your monthly credit to API credit from your control panel through the Real-time API Page.