Email Verification API

A clean, predictable REST API for verifying email addresses in real time. Sub-2-second responses, JSON output, and catch-all probability scoring built in.

Endpoints

POST

/api/verify/single

Verify a single email address. Returns status, catch-all score, MX data, and SMTP result.

curl -X POST https://verimails.com/api/verify/single \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "john@example.com"}'

POST

/api/verify/bulk

Submit a batch of up to 10,000 email addresses. Returns a job ID for async polling.

curl -X POST https://verimails.com/api/verify/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["a@example.com", "b@example.com"]}'

GET

/api/verify/bulk/{job_id}

Poll a bulk verification job for status and results.

Response Format

{
  "email": "john@acme.com",
  "status": "valid",
  "catchall": true,
  "catchall_score": 84,
  "mx": true,
  "smtp": true,
  "disposable": false,
  "role_based": false,
  "free_provider": false,
  "domain": "acme.com",
  "response_time_ms": 1240
}

status

valid, invalid, catchall, unknown, disposable, role-based

catchall_score

0–100 probability the address exists on a catch-all domain. 80+ = high confidence.

mx / smtp

MX record existence and SMTP-level deliverability check results.

Code Examples

Python

import requests

resp = requests.post(
    "https://verimails.com/api/verify/single",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={"email": "user@domain.com"}
)
result = resp.json()
print(result["status"], result["catchall_score"])

JavaScript

const res = await fetch(
  "https://verimails.com/api/verify/single",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ email: "user@domain.com" })
  }
);
const data = await res.json();
console.log(data.status, data.catchall_score);

Rate Limits

Plan	Requests/min	Monthly Credits	Concurrent
Free	10	25/day	1
Starter (5K)	60	5,000	5
Pro (10K)	120	10,000	10
Business (50K)	300	50,000	25
Enterprise	Unlimited	Custom	Custom