Real-time email validation API for developers

Python Copy

import os
import requests

API = "https://api.emailvalidation.io/v1/info"

def check_email(email: str) -> dict | None:
    try:
        r = requests.get(
            API,
            params={"email": email},
            headers={"apikey": os.environ["EMAILVALIDATION_KEY"]},
            timeout=35,
        )
        r.raise_for_status()
        return r.json()
    except requests.RequestException:
        return None  # fail open: accept, recheck later

result = check_email("anna@gmial.com")
if result and result["state"] == "undeliverable":
    suggestion = result.get("did_you_mean")  # suggested correction, if any

Node.js (18+) Copy

async function checkEmail(email) {
  const url =
    "https://api.emailvalidation.io/v1/info?email=" + encodeURIComponent(email);
  try {
    const res = await fetch(url, {
      headers: { apikey: process.env.EMAILVALIDATION_KEY },
      signal: AbortSignal.timeout(35_000),
    });
    if (!res.ok) return null;
    return await res.json();
  } catch {
    return null; // fail open: accept, recheck later
  }
}

const result = await checkEmail("anna@gmial.com");
if (result?.state === "undeliverable") {
  // ask the user to fix the address, suggesting result.did_you_mean if set
}

PHP Copy

function check_email(string $email): ?array {
    $ch = curl_init("https://api.emailvalidation.io/v1/info?email=" . urlencode($email));
    curl_setopt_array($ch, [
        CURLOPT_HTTPHEADER     => ["apikey: " . getenv("EMAILVALIDATION_KEY")],
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 35,
    ]);
    $body = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    if ($body === false || $code !== 200) {
        return null; // fail open: accept, recheck later
    }
    return json_decode($body, true);
}

$result = check_email("anna@gmial.com");
if ($result && $result["state"] === "undeliverable") {
    $suggestion = $result["did_you_mean"] ?? null;
}