SDKs for Node.js, Python, PHP, Go and Ruby

import { SimpleVerifier } from "simpleverifier";

const sv = new SimpleVerifier({ apiKey: process.env.SIMPLEVERIFIER_KEY });

const result = await sv.verifyEmail("[email protected]");
// { email: "[email protected]", status: "valid", reason: "Mailbox exists", mailbox_checked: true }

const phone = await sv.verifyPhone("07911 123456", { country: "GB" });
// { phone_status: "valid", phone_e164: "+447911123456", phone_type: "mobile", ... }

const items = await sv.verifyEmails(emails, { concurrency: 5 });
const valid = items.filter((i) => i.ok && i.result.status === "valid");

from simpleverifier import SimpleVerifier

sv = SimpleVerifier()  # reads SIMPLEVERIFIER_KEY

result = sv.verify_email("[email protected]")
# {"email": "[email protected]", "status": "valid", "reason": "Mailbox exists", "mailbox_checked": True}

phone = sv.verify_phone("07911 123456", country="GB")

items = sv.verify_emails(emails, concurrency=5)
valid = [i.email for i in items if i.ok and i.result["status"] == "valid"]

# asyncio: from simpleverifier import AsyncSimpleVerifier

// simpleverifier.mjs — Node 18+, no dependencies
const BASE = "https://simpleverifier.com/api/v1";

export class SimpleVerifierError extends Error {
  constructor(message, status) {
    super(message);
    this.status = status;
  }
}

async function call(path, body, retries = 2) {
  const res = await fetch(`${BASE}/${path}`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.SIMPLEVERIFIER_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(body),
    signal: AbortSignal.timeout(30_000),
  });
  if ((res.status === 429 || res.status === 503) && retries > 0) {
    await new Promise((resolve) => setTimeout(resolve, (3 - retries) * 1000));
    return call(path, body, retries - 1);
  }
  const data = await res.json().catch(() => ({}));
  if (!res.ok) throw new SimpleVerifierError(data.error ?? res.statusText, res.status);
  return data;
}

export const verifyEmail = (email) => call("verify", { email });
export const verifyPhone = (phone, { country, live } = {}) => call("phone", { phone, country, live });

# simpleverifier_client.py — Python 3.9+, standard library only
import json, os, time, urllib.error, urllib.request

def _call(path, body, retries=2):
    request = urllib.request.Request(
        f"https://simpleverifier.com/api/v1/{path}",
        data=json.dumps(body).encode(),
        headers={
            "Authorization": f"Bearer {os.environ['SIMPLEVERIFIER_KEY']}",
            "Content-Type": "application/json",
        },
    )
    try:
        with urllib.request.urlopen(request, timeout=30) as response:
            return json.load(response)
    except urllib.error.HTTPError as error:
        if error.code in (429, 503) and retries > 0:
            time.sleep(3 - retries)
            return _call(path, body, retries - 1)
        message = json.loads(error.read() or b"{}").get("error", error.reason)
        raise RuntimeError(f"SimpleVerifier {error.code}: {message}") from error

def verify_email(email):
    return _call("verify", {"email": email})

def verify_phone(phone, country=None, live=None):
    body = {"phone": phone}
    if country:
        body["country"] = country
    if live is not None:
        body["live"] = live
    return _call("phone", body)

import { isDisposableEmail } from "is-disposable-email-address";

isDisposableEmail("[email protected]"); // true