REST API Documentation

Programmatic email validation endpoints with real-time socket inspection and sub-400ms latency.

Get Your API Key ➔ Read Quickstart

API Overview

The Emails Verification API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON or form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes and authentication.

Base API URL
https://emailsverification.com/verify.php

Authentication

Authenticate your API requests by including your secret API key in the request header or query string. You can retrieve and manage your API keys inside your Dashboard.

We recommend passing your API key via the X-API-Key or standard Authorization: Bearer <API_KEY> HTTP header.

Method Header / Parameter Example Value
HTTP Header X-API-Key ev_live_a1b2c3d4e5f6g7h8...
Bearer Header Authorization Bearer ev_live_a1b2c3d4e5f6g7h8...
Query String api_key ?api_key=ev_live_a1b2c3d4...

Rate Limits & Plans

Requests are rate-limited on a per-account basis to protect mail exchanger servers from throttling:

  • Free & Starter Plan: 1 request per second (burst allowance with HTTP 429 response on breach).
  • Professional Plan: 10 requests per second with dedicated priority worker queue.
  • Agency & Enterprise Plan: Unlimited parallel verification throughput with custom concurrency.

Verify Single Email

Perform a real-time deep verification on an email address. Deducts 1 credit from your balance upon successful verification.

POST /verify.php
Field Type Required Description
email string Required The email address to verify (e.g. [email protected]).
api_key string Required Your secret API key (if not provided via HTTP headers).
cURL Request
curl -X POST https://emailsverification.com/verify.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ev_live_YOUR_API_KEY_HERE" \
  -d '{"email": "[email protected]"}'

JSON Response Schema

Every response returns a structured JSON payload with comprehensive deliverability diagnostics:

200 OK Response
{
  "status": "success",
  "email": "[email protected]",
  "result": "safe",
  "status_detail": "valid",
  "score": 98,
  "is_disposable": false,
  "is_role": false,
  "is_free": false,
  "mx_records": true,
  "smtp_check": true,
  "reason": "Deliverable mailbox with verified SMTP handshake",
  "credits_remaining": 9980,
  "plan": "starter"
}
Key Type Description
result string Overall classification: safe, invalid, risky, or unknown.
score number Deliverability confidence score from 0 (bad) to 100 (pristine deliverable).
is_disposable boolean true if domain belongs to a temporary burner provider (e.g. Mailinator).
is_role boolean true if account is a team alias (e.g. support@, admin@).
mx_records boolean true if target domain has active Mail Exchanger DNS routing.
smtp_check boolean true if SMTP simulation handshake completed successfully.

Multi-Language Code Examples

Drop-in code snippets to integrate email verification into your application stack:

Node.js (Fetch API)
async function verifyEmail(email) {
  const response = await fetch('https://emailsverification.com/verify.php', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.EMAILS_VERIFICATION_API_KEY
    },
    body: JSON.stringify({ email })
  });

  const data = await response.json();
  if (data.result === 'safe') {
    console.log(`Email ${email} is deliverable! Score: ${data.score}`);
    return true;
  } else {
    console.warn(`Email rejected: ${data.reason}`);
    return false;
  }
}
Python (requests)
import requests

def verify_email(email: str, api_key: str):
    url = "https://emailsverification.com/verify.php"
    headers = {
        "X-API-Key": api_key,
        "Content-Type": "application/json"
    }
    payload = {"email": email}
    
    response = requests.post(url, json=payload, headers=headers)
    data = response.json()
    
    if data.get("result") == "safe":
        print(f"Valid inbox! Confidence score: {data.get('score')}")
    else:
        print(f"Risky or invalid: {data.get('reason')}")
    return data
PHP (cURL)
<?php
function verifyEmailAddress($email, $apiKey) {
    $url = "https://emailsverification.com/verify.php?email=" . urlencode($email) . "&api_key=" . urlencode($apiKey);
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    $response = curl_exec($ch);
    curl_close($ch);
    
    return json_decode($response, true);
}
?>

HTTP Status Codes

Status Code Meaning Remediation
200 OK Successful verification Inspect JSON result and reason attributes.
400 Bad Request Missing or empty email Ensure valid email string is provided in payload.
401 Unauthorized Invalid API key Check your API key in Dashboard → API & Developers.
402 Payment Required Insufficient credits Top up your account balance at Pricing.
429 Too Many Requests Rate limit exceeded Slow down request frequency or upgrade to Professional/Agency.