# Email Finder API > Email finder API: send a name and a company domain, get a verified work email back. Pay only for valid emails. Free plan: 50 a month, no card. https://getprospect.com/developers/email-finder-api Send a name and a company domain, get back a work email that passed verification. Pay 1 email credit for a valid email and nothing for a miss. The Free plan includes the email finder API. 50 valid emails free every month. No card. Or ask Claude, ChatGPT or Cursor through [GetProspect MCP](https://getprospect.com/mcp). Rated 4.8 out of 5 on the Chrome Web Store (1,300+ ratings) and 4.0 out of 5 on G2. 140,000+ extension users. - No charge when no email is found - Accept-all and duplicates are free - No sales call to get a key Request: ```bash curl --request POST \ --url https://api.getprospect.com/v2/email/find \ --header 'x-api-key: YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data '{"data": {"first_name": "Jane", "last_name": "Doe", "domain": "acme.com"}}' ``` Response 200: ```json { "success": true, "data": { "email": "jane.doe@acme.com", "status": "valid", "domain_status": "valid", "smtp_provider": "aspmx.l.google.com", "free_email": false } } ``` [Get a free API key](https://app.getprospect.com/sign-up) ยท [Read the API docs](https://getprospect.com/api-docs.md) ## Find a work email with one API call POST a name and a company to `/v2/email/find` with your `x-api-key`, in cURL, JavaScript or Python. Every field is in the [API docs](https://getprospect.com/api-docs.md). ### Found: status valid The email, its domain status and mail server, plus your remaining credits. ### Not found: status not_found HTTP 200 with `NOT_FOUND`: no valid address could be confirmed. Accept-all domains often end here. Nothing is charged. ### Still searching: 408 A live search for a new person can run past a minute. Set a 95-second timeout; a 408 is free, so retry after Retry-After. cURL: ```bash curl --request POST \ --url https://api.getprospect.com/v2/email/find \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' \ --max-time 95 \ --data '{ "data": { "first_name": "Jane", "last_name": "Doe", "domain": "acme.com" } }' ``` JavaScript: ```javascript const res = await fetch("https://api.getprospect.com/v2/email/find", { method: "POST", headers: { "Content-Type": "application/json", "x-api-key": process.env.GETPROSPECT_API_KEY, }, body: JSON.stringify({ data: { first_name: "Jane", last_name: "Doe", domain: "acme.com" }, }), signal: AbortSignal.timeout(95_000), // a live search can run past a minute }); const body = await res.json(); if (res.status === 408) { // Still searching, not charged: ask again after Retry-After seconds console.log("Retry after", res.headers.get("retry-after"), "s"); } else if (body.success) { console.log(body.data.email); // jane.doe@acme.com } else { console.log(body.errors[0].name); // NOT_FOUND (free), or RATE_LIMIT / PAYMENT_REQUIRED: see the API docs } ``` Python: ```python import os import requests resp = requests.post( "https://api.getprospect.com/v2/email/find", headers={"x-api-key": os.environ["GETPROSPECT_API_KEY"]}, json={"data": {"first_name": "Jane", "last_name": "Doe", "domain": "acme.com"}}, timeout=95, # a live search can run past a minute ) body = resp.json() if resp.status_code == 408: # Still searching, not charged: ask again after Retry-After seconds print("Retry after", resp.headers.get("Retry-After"), "s") elif body["success"]: print(body["data"]["email"]) # jane.doe@acme.com else: print(body["errors"][0]["name"]) # NOT_FOUND (free), or RATE_LIMIT / PAYMENT_REQUIRED: see the API docs ``` Response: found: ```json { "success": true, "data": { "email": "jane.doe@acme.com", "status": "valid", "account": "jane.doe", "domain": "acme.com", "domain_status": "valid", "smtp_provider": "aspmx.l.google.com", "free_email": false }, "metadata": { "timestamp": "2026-11-10T14:07:55.000Z", "credits": { "email_search": 49, "email_verification": 1250, "wallet_usd": 1, "reset_at": "2026-12-10T00:00:00.000Z" } } } ``` Response: not found: ```json { "success": false, "data": { "email": null, "status": "not_found", "account": null, "domain": "acme.com", "domain_status": "accept_all", "smtp_provider": "mx1.acme.com", "free_email": false }, "metadata": { "timestamp": "2026-11-10T14:08:12.000Z", "credits": { "email_search": 49, "email_verification": 1250, "wallet_usd": 1, "reset_at": "2026-12-10T00:00:00.000Z" } }, "errors": [ { "name": "NOT_FOUND", "message": "Can't find email" } ] } ``` ## The email finder API that gives you verified emails Best for CRM enrichment steps, prospecting scripts and AI agents. Found emails bounce under 2% of the time, with a 98% accuracy guarantee or your credits back. ### Database first, then live A stored valid email comes back at once. If none, we build candidates from the company's email format and verify them with its mail server. ### Already yours costs nothing An email your workspace already owns comes back again at no cost, whichever teammate found it first. ### Accept-all domains checked Where a domain accepts every address, we run extra checks with the mailbox provider. Unconfirmed addresses come back `not_found`. ### One branch, not a score You get `valid` or `not_found`, never a guess or a score to interpret. ## Use the same key to search, enrich and verify ### Start from a job title Find people by title or seniority and filter to those with a verified email, with the [B2B data API](https://getprospect.com/developers), free of credits. ### Lists and LinkedIn URLs Send a list as one job, or one LinkedIn URL as an email enrichment API call, to the [data enrichment API](https://getprospect.com/developers/enrichment-api). ### Verify addresses you hold Check emails from your CRM or sign-up forms with the [email verification API](https://getprospect.com/developers/email-verification-api). ## Pay one credit per valid email, Free plan included Paid plans add more valid emails a month, 30% off with annual billing. Verification and mobile numbers use the shared team wallet. Out of email credits, Find Email answers `402`; owned emails stay free. Cancel in Settings. No call needed. See [GetProspect pricing](https://getprospect.com/pricing). | Result | Cost | | --- | --- | | Valid email, new to your workspace | 1 email credit | | Email you already own | Free | | Not found | Free | | Accept-all, not confirmed | Free | | 408 timeout | Free | [Get a free API key](https://app.getprospect.com/sign-up) ## Know your rate limits before you build Email find limits follow your plan, 1 unit per request, shared by your workspace across the API, app, Google Sheets, Zapier and MCP. The day resets at 00:00 UTC. `GET /v2/rate-limits` shows today's use; over a limit you get `429`. Each plan's per-second and daily limits are listed in [usage limits](https://getprospect.com/help-center/credits-and-billing/usage-limits.md). Every plan: unlimited teammates, 5 API keys per member, 15 days of request logs, chat support from our team. ## GetProspect Email Finder API at a glance - The GetProspect Email Finder API is `POST /v2/email/find` on `https://api.getprospect.com`, authenticated with an `x-api-key` header. - The GetProspect Email Finder API takes a person's name plus a company domain or company name, and returns a valid work email or not_found. - Cost: 1 email credit per valid email the workspace does not own yet. Not found, accept-all, owned and timed-out lookups are free. - GetProspect checks its 80M+ verified business emails first, then searches live, building and verifying candidate addresses. - Every GetProspect plan includes the Email Finder API, Free too: 50 valid emails a month, no card. ## Frequently asked questions The help center guide walks through creating an API key, reading your rate limits and the request log step by step. [Read the API keys and logs guide](https://getprospect.com/help-center/integrations-and-api/api-keys-and-logs.md) ### What is an email finder API? An email finder API turns a person's name and company into a work email inside your code. The GetProspect Email Finder API returns a verified business email or not_found. ### Is there a free email finder API? Yes. The GetProspect Email Finder API is on the Free plan: 50 valid emails a month, renewing every 30 days, no card. Not found and accept-all answers cost nothing. ### How accurate are the emails, and where does the data come from? The GetProspect Email Finder API returns only emails that passed our verification when last checked, with a 98% accuracy guarantee. If a valid email we found turns out wrong, tell us in the support chat and we return the credit after checking the case. Data comes from publicly available professional sources and licensed B2B data providers. ### Do I need a company domain, or is a company name enough? No, a company name is enough. GetProspect's Find Email endpoint takes a name plus `domain` or `company` and resolves the company to its domain, though a domain gives the best results. ### How long does an email finder API lookup take? Most lookups answer in seconds. A live search for a new person can run past a minute, so give Find Email a client timeout of at least 95 seconds. ### Can I find emails in bulk or from a LinkedIn URL? Yes, with enrichment jobs: up to 10,000 rows (name and company, LinkedIn URL or email) within your plan's daily enrich limit ([GetProspect pricing](https://getprospect.com/pricing)). A LinkedIn URL matches the profile in our database. People Enrich, the email enrichment API call, takes one person. ### Is an email lookup API the same as an email finder API? Usually, yes: both turn a name and a company into an email, and some call it an email search API. Reverse email lookup goes from an address to its owner; the GetProspect API does both. ## Test it on people whose emails you know Create a free key with your work email and run it on 20 contacts you already have. No card, no sales call. [Get a free API key](https://app.getprospect.com/sign-up)