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 therequestshelper withpip install requests. Then runpython 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 runnode verify.mjs.
curl -G "https://api.emailfinderverifier.com/api/v1/verify" \
--data-urlencode "email=jane@acme.com" \
-H "X-API-Key: YOUR_API_KEY"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 accountconst 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 supportLast updated 16.11.2026