Emails Checker API

Getting Started

The Emails Checker API is a REST-based JSON API for verifying and validating email addresses as they enter your system. Integration is straightforward, and every address you submit gets a clear, detailed verdict.

Checks go beyond basic syntax validation. The API confirms the existence of email addresses using MX-Records and the Simple Mail Transfer Protocol (SMTP), and it determines whether a mailbox is set up to catch all incoming mail traffic.

Base Endpoint

The Emails Checker API verifies email addresses through multiple layers of validation. Beyond basic syntax checks, it uses MX-Records and the Simple Mail Transfer Protocol (SMTP) to confirm that an address exists.

The API is integrated with a suite of regularly updated databases that categorize email providers into disposable (e.g., "Mailinator"), free (e.g., "Gmail", "Yahoo"), and individual domains. This categorization facilitates efficient separation and management of various types of email addresses.

The API returns a consistent JSON structure across all endpoints. Below is a detailed reference of all response fields.

Example Response

{
    "success": true,
    "response": {
        "email": "[email protected]",
        "result": "deliverable",
        "syntax": false,
        "mx_records": true,
        "smtp_code": "250",
        "catch_all": false,
        "disposable": false,
        "description": "Valid Email Address.",
        "user": "support",
        "domain": "emails-checker.net",
        "free_email": true,
        "role": true
    }
}

The API uses standard HTTP status codes to indicate the success or failure of a request. All error responses include a JSON body with details about the error.

The /credits endpoint returns the current available balance of your account.

Query Parameters

Response Parameters

HttpURLConnection conn = (HttpURLConnection) new URL(
    "https://api.emails-checker.net/credits?access_key=" + accessKey
).openConnection();

conn.setRequestMethod("GET");

if (conn.getResponseCode() == HttpURLConnection.HTTP_OK) {
    String response = new BufferedReader(
        new InputStreamReader(conn.getInputStream())
    ).lines().reduce("", String::concat);

    return new JSONObject(response).getJSONObject("response");    
}

$ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->get('https://api.emails-checker.net/credits', [
    'query' => ['access_key' => $accessKey]
]);

echo json_decode($response->getBody(), true);

$ npm install axios

const axios = require('axios');
const response = await axios.get('https://api.emails-checker.net/credits', {
    params: { access_key: accessKey }
});

return response.data.response;

$ pip install requests

url = 'https://api.emails-checker.net/credits'
response = requests.get(url, params={'access_key': access_key})
data = response.json()
return data['response']

Example Response

{
    "success": true,
    "response": {
        "credits": "100"
    }
}

The /time endpoint returns the current server time. Useful for verifying that your API key is valid and that the service is operational. It can also be used to synchronize your application's clock with the server.

Query Parameters

Response Parameters

HttpURLConnection conn = (HttpURLConnection) new URL(
    "https://api.emails-checker.net/time?access_key=" + accessKey
).openConnection();

conn.setRequestMethod("GET");

if (conn.getResponseCode() == HttpURLConnection.HTTP_OK) {
    String response = new BufferedReader(
        new InputStreamReader(conn.getInputStream())
    ).lines().reduce("", String::concat);

    return new JSONObject(response).getJSONObject("response");    
}

$ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->get('https://api.emails-checker.net/time', [
    'query' => ['access_key' => $accessKey]
]);

echo json_decode($response->getBody(), true);

$ npm install axios

const axios = require('axios');
const response = await axios.get('https://api.emails-checker.net/time', {
    params: { access_key: accessKey }
});

return response.data.response;

$ pip install requests

url = 'https://api.emails-checker.net/time'
response = requests.get(url, params={'access_key': access_key})
data = response.json()
return data['response']

Example Response

{
    "success": true,
    "response": {
        "time": "2024-01-15T10:30:00+00:00"
    }
}

Perform a single email validation request. The /check endpoint helps you verify if an email address is valid. When you use this endpoint, it performs a series of checks to make sure the email address is formatted correctly, actually exists, and can receive emails.

Query Parameters

Response Parameters

HttpURLConnection conn = (HttpURLConnection) new URL(
    "https://api.emails-checker.net/check?access_key=" + accessKey + "&email=" + email
).openConnection();

conn.setRequestMethod("GET");

if (conn.getResponseCode() == HttpURLConnection.HTTP_OK) {
    String response = new BufferedReader(
        new InputStreamReader(conn.getInputStream())
    ).lines().reduce("", String::concat);

    return new JSONObject(response).getJSONObject("response");
}

$ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->get('https://api.emails-checker.net/check', [
    'query' => [
        'access_key' => $accessKey,
        'email' => $email,
    ]
]);

echo json_decode($response->getBody(), true);

$ npm install axios

const axios = require('axios');
const response = await axios.get('https://api.emails-checker.net/check', {
    params: { 
        access_key: accessKey,
        email: email,
    }
});

return response.data.response;

$ pip install requests

url = 'https://api.emails-checker.net/check'
response = requests.get(url, params={'access_key': access_key,'email': email})
data = response.json()
return data['response']

Example Response

{
    "success": true,
    "response": {
        "email": "[email protected]",
        "result": "deliverable",
        "syntax": false,
        "mx_records": true,
        "smtp_code": "250",
        "catch_all": false,
        "disposable": false,
        "description": "Valid Email Address.",
        "user": "support",
        "domain": "emails-checker.net",
        "free_email": true,
        "role": true
    }
}