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.
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.
/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 -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:
{
"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:
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;
}
}
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
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. |