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.

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"
    }

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 file by referring to an example given below:

EndPoint

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

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

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."
}

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"
    }

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.