Programmatic Email Discovery

The Email Finder API That Verifies Before It Answers.

One POST with a name and a company domain, one poll, and you get back an SMTP-verified work address with a confidence score. An email lookup API built for enrichment pipelines, CRMs, and agents that cannot afford to guess.

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

curl -X POST "https://api.verifox.ai/v1/email-finder" \
  -H "X-API-Key: vfx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"firstName": "John", "lastName": "Doe", "domain": "stripe.com"}'
Response · 10 credits
{
  "jobId": "69d78ba337e519a86c186262"
}

Trusted by 500,000+ leading GTM teams of all sizes

10 creditsper find, charged only on the POST
60 req/minstandard API rate limit
99.9%uptime SLA, 99.99% on annual Volume
2.1B+emails verified by the engine

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 below match the API reference field for field.

POST/v1/email-finder

Starts a finder job from firstName, lastName, and domain, with an optional middleName for tighter matching. Authenticated with your X-API-Key header, costs 10 credits, and returns the jobId you poll next.

curl -X POST "https://api.verifox.ai/v1/email-finder" \
  -H "X-API-Key: vfx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"firstName": "John", "lastName": "Doe", "domain": "stripe.com"}'
Response
{
  "jobId": "69d78ba337e519a86c186262"
}
GET/v1/email-finder/:jobId

Polls the job. When status is completed, read bestMatch.email, its reachable verdict, and the confidence score. Polling is free, and history endpoints let you save, list, and clear past searches.

curl "https://api.verifox.ai/v1/email-finder/69d78ba337e519a86c186262"
Response
{
  "_id": "69d78ba337e519a86c186262",
  "status": "completed",
  "bestMatch": {
    "email": "john.doe@stripe.com",
    "reachable": "safe"
  },
  "score": 92,
  "createdAt": "2026-03-31T10:30:00Z",
  "completedAt": "2026-03-31T10:30:15Z"
}

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.

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 against the live mail server before anything comes back.

  1. POST a name and a domain

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

  2. The engine permutes and verifies

    Every plausible pattern, john.doe@, jdoe@, j.doe@, doe.john@ and the rest, is generated and pinged over a real SMTP handshake, with MX, catch-all, and disposable checks along the way.

  3. Poll the job 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.

One engine, three surfaces

An email discovery API for code, agents, and lists

Wire the REST endpoint into a backend, hand it to an AI agent over MCP, or stay in the browser with the finder tools. Same engine, same credits, same verified answers.

REST, from any language

Plain HTTPS and JSON, so the same call works from Node, Python, Go, or a cron job. Every endpoint, parameter, and response field is documented in the Email Finder API reference, including the search-history endpoints for saving and clearing past lookups.

MCP, for AI agents

The native Verifox MCP server exposes this exact endpoint as the find_email tool, with get_find_job for polling. Claude, Cursor, or any MCP client can discover a verified address mid-conversation with zero glue code.

Verification, same key

Your vfx_ key also opens the full email verification service, so you can re-check found addresses later or clean entire lists with the same 9-point engine. One account, one balance, every endpoint.

Email finder API, explained

What an email finder API actually does

An email finder APIanswers one question at machine speed: given a person’s name and the company they work for, what is their work email address? Most vendors answer it by querying a static database scraped months ago, which is why so many found addresses bounce. People change jobs, companies change email formats, and 20-40% of B2B addresses sit behind catch-all domains that accept everything during a naive check. Verifox takes the slower, honest route: the engine generates every plausible permutation of the name at that domain, then runs each one through a live SMTP handshake along with MX, disposable, role, and catch-all checks before it answers. What you get back is not a guess, it is the address a real mail server just acknowledged.

The mechanics stay deliberately small. You POST a first name, a last name, and a domain, the API returns a jobId, and a poll on that job yields a bestMatch with a reachable verdict and a confidence score. Each find costs 10 credits and polling is free. That two-call shape slots into an enrichment pipeline, a signup flow, or a CRM hygiene job without ceremony, and when a human just needs one address, the email finder tool runs the same lookup in the browser. Bigger jobs route through the bulk email finder, and company-wide discovery starts at the find email by domain page.

The verification underneath is the same 9-point engine documented on our email verification pillar, the one measuring 99.99% accuracy on a 1,000-address benchmark. Credits are pay-as-you-go and never expire, with volume tiers shown for your region on pricing, and every request and response field is specified in the API reference. Start with the free 1,000 credits and judge the answers yourself.

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.

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 APIis 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.

Start free

Your first 100 finds on us. See what a verified answer feels like.

Sign up free, grab a vfx_ key, and your first POST can run in the next two minutes. 1,000 free credits, 2,500 with a work email, and they never expire. No card required.