Your first 100,000 email verifications or 10,000 work emails found are on us.100K verifications or 10K finds, free.Sign up today

Help centerIntegrations

Use it from your own code

Copy-ready examples for calling Email Finder Verifier from cURL, Python and Node.js, with retries for rate limits. Includes how to run each one.

This page is for people who write code. Not one of those? Use Verify or find one email, Verify or find a list or Claude instead.

Each example sends one request (one question to our service). A request needs your API key (a secret password for your tools). Replace YOUR_API_KEY with your key. See Create and manage API keys.

How to run them

  • cURL is a small program for sending requests. Open the terminal (the app where you type commands). On a Mac, press Cmd+Space, type Terminal and press Enter. On Windows, click Start, type PowerShell and press Enter. Paste the command and press Enter.
  • Python is a programming language. Save the code in a file named verify.py. Install the requests helper with pip install requests. Then run python verify.py.
  • Node.js is a way to run JavaScript on your computer. Save the code in a file named verify.mjs. Set your key first. Then run node verify.mjs.
cURL
curl -G "https://api.emailfinderverifier.com/api/v1/verify" \
  --data-urlencode "email=jane@acme.com" \
  -H "X-API-Key: YOUR_API_KEY"
Python
import time, requests

KEY = "YOUR_API_KEY"

def verify(email, tries=4):
    for i in range(tries):
        r = requests.get("https://api.emailfinderverifier.com/api/v1/verify",
                         params={"email": email}, headers={"X-API-Key": KEY}, timeout=60)
        if r.status_code == 429 or r.status_code >= 500:
            time.sleep(2 ** i)  # back off and retry
            continue
        r.raise_for_status()
        return r.json()["verified"]
    raise RuntimeError("gave up after retries")

for email in ["jane@acme.com", "sam@example.com"]:
    print(email, verify(email))
    time.sleep(1)  # 1 request per second on a new account
Node.js
const KEY = process.env.EFV_API_KEY;

async function verify(email) {
  const url = "https://api.emailfinderverifier.com/api/v1/verify?email=" + encodeURIComponent(email);
  const res = await fetch(url, { headers: { "X-API-Key": KEY } });
  if (!res.ok) throw new Error("HTTP " + res.status);
  return (await res.json()).verified;
}

What the answer looks like

The answer is JSON (a simple text format that programs use to share information). It has a field called verified. true means we confirmed the mailbox. false means we couldn't. See What verification results mean.

Retry means try again

If you see a 429 error, you went too fast. The Python example waits a little and tries again. That's called a retry. New accounts can send 1 request per second and 5 at once. See Limits and common errors.

See Errors for every error code and Limits for the rate limits.

Still stuck? Ask us on Slack. Real people answer.

Get support

Last updated 16.11.2026