Programmatic Email Discovery

Email Finder API That Verifies the Address Before Answering.

POST a name and domain, get back an SMTP-verified work address with a confidence score in one call. Just one endpoint.

1,000 free credits on signup, 2,500 with a work email. No card.

Trusted by 500,000+ leading GTM teams

How it works

Permute, verify, return the winner

Most email discovery APIs hand you a pattern guess from a stale database. This one earns its answer: every candidate is checked and verified against the live mail server.

001POST

POST a name and a domain

Send firstName, lastName, and the company domain to /v1/email-finder with your X-API-Key. An optional middleName tightens the match; the API answers immediately with a jobId.

003MATCH

Poll for the bestMatch

GET /v1/email-finder/:jobId until status is completed. The bestMatch field carries the winning address, its reachable verdict, and a confidence score.

Email finder API, explained

What an email finder API actually does

Give the API a name and a company domain, and it returns the work email a real mail server just acknowledged — verified, not guessed.

An email finder API turns a name and a company domain into a verified work email. Most vendors answer from a database scraped months ago, which is why so many found addresses bounce. Verifox takes the slower, honest route: it generates every plausible permutation of the name at that domain, then runs each through a live SMTP handshake along with MX, disposable, role, and catch-all checks before it answers.

Two calls, one verified address

Find an email by name and domain

The finder runs as an async job so multi-permutation SMTP checks never block your request thread. Start it, poll it, read the bestMatch. The samples match the API reference.

Start a finder job
POST/v1/email-finder
1curl -X POST "https://api.verifox.ai/v1/email-finder" \
2 -H "X-API-Key: vfx_your_api_key" \
3 -H "Content-Type: application/json" \
4 -d '{"firstName": "John", "lastName": "Doe", "domain": "stripe.com"}'
200 — Response
1{
2 "jobId": "69d78ba337e519a86c186262"
3}
Poll for the result
GET/v1/email-finder/:jobId
1curl "https://api.verifox.ai/v1/email-finder/69d78ba337e519a86c186262"
200 — Response
1{
2 "_id": "69d78ba337e519a86c186262",
3 "status": "completed",
4 "bestMatch": {
5 "email": "[email protected]",
6 "reachable": "safe"
7 },
8 "score": 92,
9 "createdAt": "2026-03-31T10:30:00Z",
10 "completedAt": "2026-03-31T10:30:15Z"
11}

Standard rate limit is 60 requests per minute per key. Full parameter tables, error codes, and the search-history endpoints live in the API documentation.

The endpoints

Five routes cover the whole finder

One call to start a job, one to poll it, and three history routes to save, list, and clear past searches. That is the whole finder surface.

  • POST/v1/email-finder

    Start a finder job from a name and domain. Returns a jobId, 10 credits.

  • GET/v1/email-finder/:jobId

    Poll the job. When status is completed, read the bestMatch and its verdict.

  • GET/v1/email-finder/history

    Retrieve your past finder searches.

  • POST/v1/email-finder/history

    Save a found result to your search history.

  • DELETE/v1/email-finder/history

    Clear all saved searches from your history.

Request and response schemas for every route, parameter by parameter, live in the Email Finder API reference.

Trust & compliance

Discovery without a data trail

Names and addresses are processed in memory and never stored, logged, or sold. SOC 2 Type II audited, HTTPS only, with keys you can rotate from the dashboard, so contact discovery runs on the same compliance posture as the rest of the platform.

  • Claymation Japanese hanko seal in jade-green clay with a twisted shimenawa rope rim, the words SOC 2 TYPE II embossed in cream clay on its face.

    SOC 2 Type II

    Independently audited to the SOC 2 Type II standard.

  • Claymation Japanese hanko seal in cobalt-blue clay with a twisted shimenawa rope rim, the word GDPR embossed in cream clay on its face.

    GDPR

    Built for the EU with full GDPR data-subject rights.

  • Claymation Japanese hanko seal in rose-pink clay with a twisted shimenawa rope rim, the word CCPA embossed in cream clay on its face.

    CCPA

    California opt-out, do-not-sell, plus DSAR handling.

  • Claymation Japanese hanko seal in terracotta clay with a twisted shimenawa rope rim, the text ISO 27001 embossed in cream clay on its face.

    ISO 27001

    Information security held to the ISO 27001 standard.

  • Claymation Japanese hanko seal in lilac-purple clay with a twisted shimenawa rope rim, the text ISO 42001 embossed in cream clay on its face.

    ISO 42001

    AI governance aligned to the new ISO 42001 standard.

Free field manual

The Dead List

An investigation into the money leaking out of your list - and the nine checks that decide whether your email is read, or never arrives at all.

The Dead List field manual, held up by the Verifox fox
Get the free manual

57 pages, free PDF, no signup

Common questions

Email finder API, answered

How the lookup works, what a find costs, where the accuracy comes from, and how the API compares to the browser tools, with the real numbers behind each answer.

What is an email finder API?

An email finder API is an endpoint that takes a person’s name and a company domain and returns their work email address programmatically, so your product, CRM enrichment job, or outbound pipeline can discover addresses without a human pasting names into a web form.

The Verifox version goes one step further: it verifies every candidate over SMTP before answering, so the address you receive is one the engine actually reached, not a pattern guess. For one-off lookups in the browser, the email finder tool runs the same engine without any code.

How does the find email by name and domain endpoint work?

You POST firstName, lastName, and domain to /v1/email-finder and get a jobId back right away. The engine then generates every plausible permutation of that name at that domain and verifies each one with a live SMTP handshake, plus MX, catch-all, and disposable checks.

When you poll GET /v1/email-finder/:jobId and status reads completed, the bestMatch field holds the winning address with its reachable verdict and a confidence score. The full request and response shapes are in the API reference.

How accurate are the emails the API returns?

Every result passes through the same 9-point engine that scores 99.99% accuracy on a 1,000-address benchmark list: syntax, domain and MX records, a real SMTP mailbox ping, disposable and role detection, catch-all detection, and AI-confidence scoring on catch-all domains.

That last part matters because 20-40% of B2B addresses sit behind catch-all domains where a plain handshake says yes to everything. The confidence score in the response tells you how much to trust each match, and the deeper checks are described on the email verification service page.

What does an email lookup cost?

One find costs 10 credits, charged when you start the job. Polling the job status is free. A new account starts with 1,000 free credits, or 2,500 if you sign up with a work email, and no card is required.

Past the free balance, credits are pay-as-you-go and never expire, so a quiet month costs nothing. Volume tiers are shown for your region on the pricing page.

How do I authenticate requests?

Send your key in the X-API-Key header on every request, exactly as the code samples on this page show. Keys look like vfx_... and are generated in the dashboard after you create a free account.

Keep the key server-side. Calls travel over HTTPS only, and you can rotate or revoke a key from the dashboard at any time without touching the others.

What are the rate limits, and how fast are jobs?

The standard limit is 60 requests per minute per key. Finder jobs run asynchronously, so the POST returns in milliseconds and the verification work happens in the background; the documented example job completes in about 15 seconds.

The underlying verification engine runs at a median of ~380 ms per single check and sub-50 ms on cached results, which is what keeps multi-permutation jobs quick. If you hit a 429, back off briefly and retry.

Can I find emails in bulk?

Yes. Because each find is one POST, you can queue an entire prospect list by firing requests inside the rate limit and polling the jobIds as they complete. For spreadsheet-sized batches without code, the bulk email finder handles upload, dedupe, and export in the browser.

And when you need every address at one company rather than one person, the find email by domain tool and the domain email extractor work the problem from the company side.

Is finding someone's work email GDPR compliant?

B2B contact discovery is generally processed under legitimate interest, but the obligations are yours: a lawful basis, a clear opt-out in outreach, and honoring erasure requests. The API only returns business addresses inferred from public name-at-domain patterns, never scraped personal inboxes.

On our side, Verifox is SOC 2 Type II audited, and addresses are processed in memory, never stored, logged, or sold. The data-handling detail lives in the privacy policy.

How is the API different from the web email finder?

Same engine, different surface. The web email finder is built for a human doing a handful of lookups, while the API is built for volume and automation: enrichment pipelines, CRM hygiene jobs, signup-form enrichment, anything that runs without a person watching.

The API also gives you the raw job object, so you can branch on the reachable verdict and confidence score in code, and the history endpoints let you save and query past searches. For LinkedIn-specific workflows there is a dedicated LinkedIn email finder.

Can AI agents use the email finder API?

Yes, natively. The Verifox MCP server wraps this endpoint as the find_email tool with get_find_job for polling, so Claude, Cursor, or any MCP client can turn a name and a domain into a verified address inside an agent loop.

Both paths bill the same 10 credits per find against the same balance. If you are building retrieval into a product rather than an agent, the plain REST endpoint on this page is usually the simpler wire. The AI email finder page covers the agent-side workflow in more depth.