Bulk Email Verification API Documentation | Verify Emails at Scale

Bulk Email Verification API

Introduction

Welcome to the EmailVerify.io Bulk Email Verification API! This API allows you to validate up to 5000 email addresses in real-time with the help of a simple request, ensuring accuracy and reliability for your email communications.

This endpoint allows you to send us batches of up to 5000 emails at a time. If you're looking to validate a single email address, please use our single email validator endpoint.

Authentication

To access the API, you’ll need a valid API key. You can generate your personal key from the API section after logging into your account. This key is required for authentication and to make requests securely.

API Endpoint

Validate a batch of email addresses by sending your API key and email batch in the body of POST request.

Post Request URL (HTTPS)

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

Post Request

You can validate up to 5000 email addresses by submitting them in the following POST request.

Post (Body):

{ "title": "Task Name" ,

"key": "Your_API_Key" ,

"email_batch": [

{ "address": "valid1@example.com" },

{ "address": "valid2@example.com" },

{ "address": "valid3@example.com" }]}

Example Success Response

You will receive a response like this when your bulk verification task is successfully created.

{ "status": "success" ,

"task_id": "12345" ,

"count_submitted": 3 ,

"count_duplicates_removed": 0 ,

"count_rejected_emails": 0 ,

"count_processing": 3 }

Get Request

Use this endpoint to retrieve the results of a previously created bulk email verification task. The results will include the overall status of the task and, if the task has completed, the results of the email verification.

Get Request URL (HTTPS)

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

Example Success Response

Here’s a sample response once your verification task is complete:

Success Response for a GET Request

{ "count_checked": 1 ,

"count_total": 1 ,

"name": "Task Name" ,

"progress_percentage": "100%" ,

"task_id": "1234" ,

"status": "verified" ,

"results": {

"email_batch": [

{ "address": "valid@example.com" ,

"status": "invalid" ,

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

Checks Performed in Bulk Email Validation

Error Responses

Error Message Description
Invalid API Key The provided API key is disabled or does not exist.
Invalid Request Invalid parameters were provided in the API endpoint.
0 Credits Remaining You do not have enough credits.
Please Try Again An internal error occurred. Try the request again.

 

Check Account Balance

Use the following GET request to check your current account balance.

Get Request URL (HTTPS):  

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

Here, replace the <Your_API_Key> with your active API key.

Response (JSON):  

{ "api_status": "enabled" ,

"available_credits": 16750 }


Available credits are the total of your daily available credits, refunded credits, and Bonus Credits. The following endpoint is deprecated and will be removed in future versions.

Get Request URL (HTTPS) [Deprecated]:  


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

Here, replace the <Your_API_Key> with your active API key.

Response (JSON):  

{ "api_status": "enabled" ,

"daily_credits_limit": 150 ,

"bonus_credits": 100 ,

"remaining_credits": 15000 }