Real Time Email Verification API

Our Email Validation Real-Time API is simply based on the JSON web service, which allows developers to verify individual email addresses on-demand as a user enters them in a web form or mobile application.

MyEmailVerifier API is a powerful tool designed to verify email addresses efficiently and accurately. It offers various functionalities to validate single emails and bulk files containing email lists. This documentation provides detailed information on API endpoints, request parameters, response formats, and additional features to assist users in integrating MyEmailVerifier seamlessly into their applications.

URL for API info: https://client.myemailverifier.com/apisettings (required login)

API Responses

Our API divides email statuses in 5 ways.

Valid: Valid email represents that account is real and available at the given domain
Invalid: Not a real email
Unknown: When we cannot verify valid or invalid due to some reason. Generally most of the time a domain didn’t respond quick enough.
Catch All: The domains which respond to every verification in the affirmative, therefore they cannot be fully verified.
Grey-listed: This domain doesn’t respond in the first attempt, It is advisable to retry after 5-10 hours.

Optional Inputs

Address: provided email.
Status: Can be either Valid, Invalid, Grey-listed or Unknown
StatusCode: SMTP server status code for advance users
Disposable_Domain: If the domain is disposable
Free_Domain: If email is not a business address
Greylisted: Server will not respond properly in the first attempt. Frequent multiple attempts are not advisable.
Diagnosis: Helpful information about Invalid address

Verify an Email - Real-Time Verification API

API - Validate Single Email Documentation

Looking to validate emails via our email validation API? Here is an explanation of how you can use our Single Email Validation through an API.

EndPoint

GET:

https://client.myemailverifier.com/verifier/validate_single/[email protected]/API_KEY

NOTE: <API_KEY> - You can find your API key from your client area - API section.

Example Request

curl --get --include "https://client.myemailverifier.com/verifier/validate_single/[email protected]/API_KEY"

Example Response

 {
        "Address":"[email protected]",
        "catch_all": "false",
        "Status":"Valid",
        "Disposable_Domain":"false",
        "Role_Based":"true"
        "Free_Domain":"false",
        "Greylisted":"false",
        "Diagnosis":"Mailbox Exists and Active"
    }

Status Code: 200

Other Response:

Response Status: false
Response Messages:

Verify your payment for uninterrupted service. Reply to our recent email with the requested card and ID documents. Thank you for helping us ensure secure transactions.
Your Account is blocked. Please contact support for more details.
You do not have enough credits.
Unknown error occurred.

API - Get Credits Documentation

Here is an explanation of how you can use our Get Credits API

EndPoint

GET:

https://client.myemailverifier.com/verifier/getcredits/API_KEY

NOTE: <API_KEY> - You can find your API key from your client area - API section.

Example Request

curl --get --include https://client.myemailverifier.com/verifier/getcredits/API_KEY

Example Response

{
	Credits: "7800"
}

API - Upload File for bulk verification Documentation

Here is an explanation of how to validate a file using an API. You can upload a TXT/CSV/XLSX file by referring to an example given below:

EndPoint

https://client.myemailverifier.com/verifier/upload_file

POST Variable: api_key (string), filename (fileupload)

file: The bulk file containing email addresses. Allowed formats are TXT, CSV, and XLSX.

Example Request

if (function_exists('curl_file_create'))
    {
        $file = curl_file_create('c:\temp\emails.txt');
    }
    else
    {
        $file = '@c:\tempemails.txt';
    }
    $data['filename'] = $file;
    $data['api_key'] = 'API_KEY';
    $url = 'https://client.myemailverifier.com/verifier/upload_file/';
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    $file_id = curl_exec($ch); //return FILE ID to get file status and download url
    curl_close($ch);

Example Response

{
	"status": true,
	"file_name": "emails.txt",
	"file_id": 1670,
	"msg": "File uploaded successfully."
}

Status Code: 200

Other Response

Response Status: false
Response Messages:

Missing API Key
Invalid API Key
Your Account is blocked. Please contact support for more details.
Verify your payment for uninterrupted service. Reply to our recent email with the requested card and ID documents. Thank you for helping us ensure secure transactions.
Please select a file,Your file contains invalid format data,Incorrect file format. Allowed files are txt, csv and xlsx
We did not find your purchase details.
The file contains an invalid data format. There should only be one email value per row
There are {no_of_lines} lines in your file, but only {credits} credits are available in your account. Please purchase credits so that your file can be processed.
Your purchase details were not found, so we are unable to authorize you to validate the files. Please contact [email protected] for assistance.
The file is too large. Please upload a file with a maximum of 100k rows.

API - Get File Info Documentation

We assume that you have uploaded a file using our File Upload API. Now, here is an explanation of how you can get the status of your uploaded file using our Get File API.

EndPoint

GET:

https://client.myemailverifier.com/verifier/file_info/API_KEY/FILE_ID

NOTE1: <API_KEY> - You can find your API key from your client area - API section.

NOTE2: <File_ID> - You will get your file ID in the response of Upload File API.

Example Request

curl --get --include "https://client.myemailverifier.com/verifier/file_info/API_KEY/FILE_ID"

Example Response

{
        "upload_id": "1669",
        "file_name": "test_20190909001723.xlsx",
        "file_path": "https://client.myemailverifier.com/downloadreport/csv/FILEID",
        "xls_file_path": "https://client.myemailverifier.com/downloadreport/xls/FILEID",
        "user_id": "26",
        "created_at": "2019-09-09 00:17:23",
        "ready_for_download": "1",
        "valid": "27",
        "invalid": "2",
        "catchall": 0,
        "unknown": 0,
        "duplicates": 0,
        "spam_trap": 10,
        "toxic_domains": 0,
        "credit_used": "29",
        "total": "31",
        "status": "finished"
    }

Authentication Errors

Authentication: To utilize the MyEmailVerifier API, users must acquire an API key. This key serves for authentication purposes and must be included in the request headers for every API call.

Unauthorized Request

Status code: 200
Response Status: false
Response Message: Unauthorized Request

Invalid API Key

Response Status: false
Response Message: Invalid API Key

Rate Limit

Rate Limit: 30 requests per minute

Status Code: 429

Example Response

 {
    "status": false,
    "message": "Too many requests. Please try again later.",
    "retryAfter": 60
}

Additional Information

Protect your API Key: Your API Key is required to use our Email verification API. Store it in a safe place. You can change it at any time. You are responsible for the cost of all verifications processed with it.

If you have any further queries kindly contact us.