Email verification API

POST/verify

Verify one email address in real time.

curl -X POST https://easymailverify.com/api/v1/verify \
  -H "Authorization: Bearer $EMV_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f1c2b8e-3d4a-4f5b-9c7d-1e2f3a4b5c6d" \
  -d '{"email": "jane@acme.com", "label": "Sign-up form"}'

Response

{
  "id": "1b6a…",
  "email": "jane@acme.com",
  "status": "passed",
  "result_code": "deliverable",
  "reason": "The mail server confirmed this mailbox exists and accepts mail.",
  "credits_used": 1,
  "suggested_email": null,
  "mailbox": "jane",
  "domain": "acme.com",
  "mailbox_provider": "Custom Domain",
  "disposable": false,
  "role_account": false,
  "free_provider": false,
  "catch_all": false,
  "spam_complainer": false,
  "gibberish": false,
  "offensive": false,
  "mail_server": {
    "hostname": "aspmx.l.google.com",
    "hostnames": ["aspmx.l.google.com", "alt1.aspmx.l.google.com"],
    "ip": "142.250.0.27",
    "organization": "Google LLC",
    "asn": 15169,
    "country": "United States",
    "country_code": "US",
    "timezone": "America/Chicago"
  },
  "checks": { "syntax": "pass", "dns": "skip", "mx": "pass", "smtp": "pass", "mailbox_exists": "pass", "disposable": "pass", "role": "pass" },
  "checked_at": "2026-10-05T09:00:00Z",
  "duration_ms": 640,
  "label": "Sign-up form"
}

• 200 with the result, usually within seconds.
• If the check needs longer you get 202 with {"id": "…", "status": "queued"}. Poll GET /verify/{id}.
• status is passed, failed or unknown. Passed and failed use 1 credit; unknown uses none.
• label is optional (up to 100 characters) and is returned with the result.
• See Response fields and Result codes below for every field.

GET/verify/{id}

Get the result of a single check.

curl https://easymailverify.com/api/v1/verify/1b6a… -H "Authorization: Bearer $EMV_API_KEY"

Response

// 200 with the same body as POST /verify, or while still checking:
{ "id": "1b6a…", "status": "queued" }   // HTTP 202

POST/lists

Submit a list of up to 50,000 addresses for bulk verification.

curl -X POST https://easymailverify.com/api/v1/lists \
  -H "Authorization: Bearer $EMV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "March newsletter", "emails": ["a@example.com", "b@example.com"]}'

Response

{
  "id": "7c41…",
  "status": "queued",
  "submitted": 2,
  "unique_emails": 2,
  "duplicates_removed": 0,
  "invalid_removed": 0,
  "max_credits": 2
}   // HTTP 202

• Duplicates and invalid addresses are removed before checking and never cost credits.
• max_credits is reserved while the list runs; you're charged only for passed and failed results.

GET/lists/{id}

Check a list's progress and totals.

curl https://easymailverify.com/api/v1/lists/7c41… -H "Authorization: Bearer $EMV_API_KEY"

Response

{
  "id": "7c41…",
  "name": "March newsletter",
  "status": "processing",        // queued | processing | complete
  "unique_emails": 2,
  "processed": 1,
  "passed": 1, "failed": 0, "unknown": 0,
  "credits_used": 1,
  "created_at": "2026-10-05T09:00:00Z",
  "completed_at": null,
  "results_deleted_at": null
}

GET/lists/{id}/results?limit=1000&offset=0

Page through a list's results (up to 5,000 per page).

curl "https://easymailverify.com/api/v1/lists/7c41…/results?limit=1000&offset=0" -H "Authorization: Bearer $EMV_API_KEY"

Response

{
  "id": "7c41…",
  "offset": 0,
  "limit": 1000,
  "results": [
    { "email": "a@example.com", "status": "passed", "result_code": "deliverable", "reason": "…", "credits_used": 1, "suggested_email": null, "disposable": false, "mail_server": { "hostname": "…" }, … }
  ]
}

• Results are permanently deleted 7 days after verification; fetch them before then.

GET/balance

Check your available credits.

curl https://easymailverify.com/api/v1/balance -H "Authorization: Bearer $EMV_API_KEY"

Response

{ "credits_available": 9850, "credits_reserved": 150 }