Bulk Email Verification API

EmailVerify.io offers a Bulk Email Verification API designed to validate up to 5,000 email addresses in real time with a single request. It is designed for developers who need to process large batches of email addresses programmatically, ensuring accuracy and reliability at scale.

For single address validation, use the Instant Email Verification API.

Authentication

All API requests require a valid API key for authentication. Your API key can be generated from the API section of your EmailVerify.io dashboard after logging in. Include this key in every request as shown in the examples below.

API Endpoint

The Bulk Email Verification API uses a two-step process: a POST request to submit your batch and a GET request to retrieve the results.

POST Request: Submit Your Batch

Use the following endpoint to submit a batch of up to 5,000 email addresses for verification.

Request URL (HTTPS)
Copied!

https://app.emailverify.io/api/v1/validate-batch

Request Body

JSON
Copied!

{ "title": "Task Name" ,

"key": "Your_API_Key" ,

"email_batch": [

{ "address": "[email protected]" },

{ "address": "[email protected]" },

{ "address": "[email protected]" }]}

Example Success Response

A successful POST request returns the following JSON response:

JSON
Copied!

{ "status": "success" ,

"task_id": "12345" ,

"count_submitted": 3 ,

"count_duplicates_removed": 0 ,

"count_rejected_emails": 0 ,

"count_processing": 3 }

GET Request: Retrieve Your Results

Once your batch has been submitted, use the following endpoint to retrieve the results of your verification task. 

Request URL (HTTPS)
Copied!

https://app.emailverify.io/api/v1/get-result-bulk-verification-task?key=<Your_API_Key>&task_id=<Task_ID>

Replace Your_API_Key with your active API key and Task_ID with the task ID returned from your POST request.

Example Success Response

A completed verification task returns the following JSON response:

JSON
Copied!

{ "count_checked": 1 ,

"count_total": 1 ,

"name": "Task Name" ,

"progress_percentage": "100%" ,

"task_id": "1234" ,

"status": "verified" ,

"results": {

"email_batch": [

{ "address": "[email protected]" ,

"status": "invalid" ,

"sub_status": "No dns entries"}]}}

Checks Performed

Each email address submitted to the API goes through the following validation checks:

Error Responses

If a request fails, the API will return one of the following error messages:

Check Account Balance

Use the following GET request to retrieve your current account credit balance.

Request URL (HTTPS)
Copied!

https://app.emailverify.io/api/v2/check-account-balance?key=<Your_API_Key>

Replace Your_API_ Key with your active API key.

Response

JSON
Copied!

{ "api_status": "enabled" ,

"available_credits": 16750 }

The available_credits value represents the total of your daily available credits, refunded credits, and bonus credits combined.

Next Steps

Your next large-scale verification is one API call away!

Generate your API key with EmailVerify.io and integrate bulk email verification directly into your workflow.