API Documentation
Instant Verification Instructions
+ Generate New API KeyIntroduction
Welcome to the EmailVerify.io Single Email Validation API! This API allows you to validate a single email address in real time with the help of a simple request, ensuring accuracy and reliability for your email communications.
Authentication
To access the API, you need a valid API key. You can generate your personal API 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 single email address by replacing the placeholders with your unique API key and the email address to be validated in the following URL:
https://app.emailverify.io/api/v1/validate?key=yourapikey&email=valid@example.com
Example Success Response
You would get a response like this if your single email request is successfully processed:
{ "email": "jhon123@gmail.com", "status": "valid" }
Checks Performed in single email validation
Regex Validation: Verify the structure of email addresses against industry-standard regex patterns to catch typos and formatting errors before further processing.
MX Validation: Check for valid Mail Exchange (MX) records to confirm the email domain is configured to receive messages, ensuring it exists and is active.
MX Blacklist Validation: Identify domains listed on known blacklists for spam or malicious activity, helping you avoid unreliable or harmful email destinations.
SMTP Validation: Conduct real-time verification by pinging the recipient's SMTP server to confirm the email address is live and capable of receiving emails.
Error Responses
Check Account Balance
Please use the following GET request to check the current account balance (remaining daily and instant credits).
https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>
Here, replace the <Your_API_Key> with your active API key.
{ "api_status": "enabled", "daily_credits_limit": 150, "remaining_credits": 15000 }
Bulk Verification Instructions
+ Generate New API KeyIntroduction
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 communication.
This endpoint allows you to send us batches of up to 5000 emails at a time. If you're looking to do single email validations, please use our single email validator endpoint.
Authentication
To access the API, you’ll need a valid API key. 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
To validate your email addresses, replace the placeholder with your unique API key and include the email addresses in the body of the
POST request.
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.
{ "title": "Task Name", "key": "Your_API_Key", "email_batch": [ { "address": "valid@example.com" }, { "address": "invalid@example.com" }, { "address": "catch_all@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
This endpoint retrieves 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.
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:
{ "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" } ] } }
Checks Performed in Bulk Email Validation
Regex Validation: Verifies the structure of email addresses against industry-standard regex patterns to catch typos and formatting errors before further processing.
MX Validation: Checks for valid Mail Exchange (MX) records to confirm the email domain is configured to receive messages, ensuring it exists and is active.
MX Blacklist Validation: Identifies domains listed on known blacklists for spam or malicious activity, helping you avoid unreliable or harmful email destinations.
SMTP Validation: Conducts real-time verification by pinging the recipient's SMTP server to confirm the email address is live and capable of receiving emails.
Error Responses
Check Account Balance
Please use the following GET request to check the current account balance (remaining daily and instant credits).
https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>
Here, replace the <Your_API_Key> with your active API key.
{ "api_status": "enabled", "daily_credits_limit": 150, "remaining_credits": 15000 }