# Email Verification API for one email or a list > Email verification and validation API: check one address in real time or 10,000 per job. $0.80 per 1,000, unknown results free. Start on the Free plan. https://getprospect.com/developers/email-verification-api Verify one address live or up to 10,000 per job. Each email comes back valid, invalid, accept_all or unknown, at $0.80 per 1,000. The API is on the Free plan, with a one-time $1 in your wallet: 1,250 verifications. No card, no sales call. Or verify through Claude, ChatGPT or Cursor with the [GetProspect MCP server](https://getprospect.com/mcp), or the Zapier action Verify Email Address. 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. - A 408 timeout is never charged - Unknown results are free - No rate limit on verification Request: ```bash curl --request POST \ --url https://api.getprospect.com/v2/email/verify \ --max-time 80 \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' \ --data '{ "data": { "email": "jane.doe@acme.com" } }' ``` Response 200: ```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 } } ``` [Start free](https://app.getprospect.com/sign-up) · [Read the API docs](https://getprospect.com/api-docs.md) [The Logit Group](https://getprospect.com/customer-stories/logit-group) and [Teamcal Ai](https://getprospect.com/customer-stories/teamcal-ai) verify their own lead lists with GetProspect. ## Verify an email with one API call Plain REST and JSON with one `x-api-key` header: copy a call, add your key, run it. Bigger lists go as several jobs, or as a file of up to 1,000,000 emails in the [bulk email verifier](https://getprospect.com/email-verifier/bulk-email-verifier). ### Create an API key Sign up free, open the **API** page in the app and click Create API Key. ### Check one address live POST it to `/v2/email/verify` with an 80-second timeout. A 408 timeout is never charged. ### Send a list as a job POST up to 10,000 addresses to `/v2/email-verifications` with an `Idempotency-Key`, so a retry never charges twice. cURL: ```bash # 1. Verify one address (live check: allow up to 80 seconds) curl --request POST \ --url https://api.getprospect.com/v2/email/verify \ --max-time 80 \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' \ --data '{ "data": { "email": "jane.doe@acme.com" } }' # 2. Verify a list: up to 10,000 addresses per job curl --request POST \ --url https://api.getprospect.com/v2/email-verifications \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' \ --header 'Idempotency-Key: signups-2026-11-11' \ --data '{ "data": { "name": "Signups", "emails": ["jane.doe@acme.com", "john.smith@example.com"] } }' # 3. Get told when it ends (subscribe once per workspace) curl --request POST \ --url https://api.getprospect.com/v2/webhooks \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' \ --data '{ "url": "https://example.com/hooks/getprospect", "events": ["job.finished"] }' # 4. Read the results of the completed job, 500 per page, valid only curl --url 'https://api.getprospect.com/v2/email-verifications/JOB_ID/results?limit=500&status=valid' \ --header 'x-api-key: YOUR_API_KEY' ``` JavaScript: ```javascript const BASE = "https://api.getprospect.com/v2"; const headers = { "Content-Type": "application/json", "x-api-key": process.env.GETPROSPECT_API_KEY, }; // 1. Verify one address (live check: allow up to 80 seconds) const res = await fetch(`${BASE}/email/verify`, { method: "POST", headers, body: JSON.stringify({ data: { email: "jane.doe@acme.com" } }), signal: AbortSignal.timeout(80_000), }); const { data } = await res.json(); console.log(data.status); // valid | invalid | accept_all | unknown // 2. Verify a list: up to 10,000 addresses per job const job = await fetch(`${BASE}/email-verifications`, { method: "POST", headers: { ...headers, "Idempotency-Key": "signups-2026-11-11" }, body: JSON.stringify({ data: { name: "Signups", emails } }), }).then((r) => r.json()); // 3. Wait until the job is completed (or react to the job.finished webhook instead) let j; do { await new Promise((r) => setTimeout(r, 10_000)); j = await fetch(`${BASE}/email-verifications/${job.data.id}`, { headers }).then((r) => r.json()); } while (!j.data.results_available && !j.data.error); // 4. Page the results, 500 at a time let cursor = null; const results = []; do { const q = new URLSearchParams({ limit: "500", ...(cursor && { cursor }) }); const page = await fetch( `${BASE}/email-verifications/${job.data.id}/results?${q}`, { headers }, ).then((r) => r.json()); results.push(...page.data); cursor = page.metadata.pagination.next_cursor; } while (cursor); ``` Python: ```python import os import time import requests BASE = "https://api.getprospect.com/v2" HEADERS = {"x-api-key": os.environ["GETPROSPECT_API_KEY"]} # 1. Verify one address (live check: allow up to 80 seconds) r = requests.post( f"{BASE}/email/verify", headers=HEADERS, json={"data": {"email": "jane.doe@acme.com"}}, timeout=80, ) print(r.json()["data"]["status"]) # valid | invalid | accept_all | unknown # 2. Verify a list: up to 10,000 addresses per job job = requests.post( f"{BASE}/email-verifications", headers={**HEADERS, "Idempotency-Key": "signups-2026-11-11"}, json={"data": {"name": "Signups", "emails": emails}}, ).json()["data"] # 3. Wait until the job is completed (or react to the job.finished webhook instead) while True: time.sleep(10) j = requests.get(f"{BASE}/email-verifications/{job['id']}", headers=HEADERS).json()["data"] if j.get("results_available") or j.get("error"): break # 4. Page the results, 500 at a time results, cursor = [], None while True: params = {"limit": 500, **({"cursor": cursor} if cursor else {})} page = requests.get( f"{BASE}/email-verifications/{job['id']}/results", headers=HEADERS, params=params, ).json() results += page["data"] cursor = page["metadata"]["pagination"]["next_cursor"] if not cursor: break ``` ## Know which addresses take mail before you send The email validation API runs every check in one call, without sending an email: use it on new signups, before a CRM import or before a campaign. ### Mailbox checked, no email sent Syntax, MX records, disposable domains and the mailbox itself, with retries when a server greylists the check. ### Accept-all, labelled not guessed On domains that accept every address, we run extra checks with the mailbox provider. What stays unconfirmed returns accept_all. More on [catch-all emails](https://getprospect.com/email-verifier/catch-all-emails). ### More than a yes or no Each email check API result also names the mail provider, the domain status and whether it is a free mailbox such as Gmail. ### Find, then verify The same key finds emails with the [email finder API](https://getprospect.com/developers/email-finder-api) and fills records with the [data enrichment API](https://getprospect.com/developers/enrichment-api). Found emails already passed our verification when last checked. ## Pay per check, and never for an unknown One flat $0.80 per 1,000 checks ($0.0008 each) on every plan, Free included: 10,000 addresses cost $8. You pay from the wallet, a US-dollar balance your team shares. Top up from $50; larger top-ups add a bonus of up to 50%. Each plan payment adds 20% (see [GetProspect pricing](https://getprospect.com/pricing)). Prices exclude tax. Cancel any time, yourself, in Settings. | What happens | Cost | | --- | --- | | Single check: badly formed or timed out (408) | Free | | Single check with an empty wallet | Not run (402), nothing charged | | Bulk job: each unique, well-formed address | $0.0008, charged at start | | Bulk job: duplicates, blanks, badly formed | Free | | Bulk job: unknown and never-verified rows | Back to the wallet at the end | ## What each email verification status means Every GetProspect result is one of four statuses, each with a clear next step. | Status | What it means | What to do | Cost | | --- | --- | --- | --- | | valid | The mail server confirmed the mailbox exists | Send | $0.0008 | | invalid | The mailbox does not exist or the domain is disposable | Remove it | $0.0008 | | accept_all | The domain takes every address; extra checks could not confirm this one | Send with care, or keep apart | $0.0008 | | unknown | The server did not answer, for example it was down or blocking checks | Check again later | Free | ## Limits and what every plan includes | Item | Limit | | --- | --- | | Single checks and bulk verification | No rate limit, any plan | | Addresses per bulk job | 1 to 10,000 | | Creating bulk jobs | 1,000 a day, every plan | | Polling, reading results, webhooks | Free; polling and results up to 10 requests a second | | Teammates | Unlimited on every plan | ## Email address verification API at a glance - The GetProspect email verifier API checks one address per call (POST /v2/email/verify, live, up to 75 seconds) or 1 to 10,000 per bulk job (POST /v2/email-verifications). - Each GetProspect result is valid, invalid, accept_all or unknown, with the domain status, mail provider and a free-email flag. - GetProspect email verification costs $0.80 per 1,000 from the team wallet on every plan; unknown results and duplicates are free. - The GetProspect API works on every plan, Free included; email verification is never rate limited. - GetProspect does not add the emails you verify to its database. Verification results are deleted after 30 days. ## Email verification API: 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 verification API? An email verification API is a web service your code calls to check whether an address can receive mail. The GetProspect API checks syntax, MX records and disposable domains, then asks the mail server whether the mailbox exists, without sending an email. ### Is there a free email verification API? Yes, to start. The GetProspect Email Verification API is on the Free plan, with no card and a one-time $1 in the wallet: 1,250 verifications. The Free plan's 50 valid emails a month are for the email finder. After that, verification costs $0.80 per 1,000. ### How do I verify an email address with the API? Send the address to POST /v2/email/verify with your key in the x-api-key header. The GetProspect check runs in real time and can take up to 75 seconds, so set an 80-second timeout and call it from a background step, not while a form waits. ### How many emails can I verify per API request? One per call on POST /v2/email/verify, and 1 to 10,000 per job on the GetProspect bulk email verification API. If the wallet is short, a bulk job waits until the balance covers it, and a single check is not run. ### What does accept_all mean in the API response? Accept_all means the domain accepts mail for every address, so its server cannot confirm one mailbox. GetProspect then runs extra checks with the mailbox provider, such as Microsoft 365 or Google Workspace, and labels what it still cannot confirm accept_all, not guessed. ### Is the email verification API rate limited? No. Email verification is never rate limited on any GetProspect plan. Creating bulk jobs is limited on every plan: 2 per second, 30 per minute and 1,000 per day. Polling and reading results are free, up to 10 requests per second. ### What is the difference between email validation and email verification? Email validation usually means checking the format and the domain; email verification also asks the mail server whether the mailbox exists. The GetProspect API does both in one call, so it works as an email validator API and an email verification API. ### Do you add the emails I verify to your database? No. GetProspect does not add the emails you verify to its database. Bulk results and single-check history are deleted after 30 days; copies in encrypted backups expire within 124 days. Files uploaded to the bulk verifier are stored on AWS in the EU; a [data processing agreement](https://getprospect.com/dpa) is available. ### Do I need to verify emails GetProspect finds for me? Usually not. Emails from the GetProspect database and email finder are delivered only when they passed our verification when last checked, which supports 98% deliverability. Use the API for addresses from elsewhere or for old lists. One address by hand? Use the free [email verifier](https://getprospect.com/email-verifier). ### Can a valid email address still bounce? Yes, sometimes. Valid means the mail server confirmed the mailbox exists when GetProspect checked it. Verification lowers bounce risk but cannot promise delivery. Test GetProspect on your own data: ten addresses you know are live and ten that bounced. ## Verify your first 1,250 emails on the Free plan Create a key, run a list you already sent to and compare the results with what bounced. No card, no sales call. The same key opens the full [B2B data API](https://getprospect.com/developers): people search, company search and enrichment. [Start free](https://app.getprospect.com/sign-up) · [Read the API docs](https://getprospect.com/api-docs.md)