Endpoint reference

List Keys — List the API keys belonging to the authenticated caller. Authenticate with any active key you own (`X-API-Key`) — the response is scoped to that key's `owner_email`. Secrets are never returned, only metadata.
emailverify keys:get · MCP get_keys

Create Key — Create an API key. The key is returned once and cannot be retrieved again. Anonymous callers may self-serve a key, but must supply a real `owner_email` — it is what scopes `GET /keys`, rotation and revocation later. Authenticated callers always get the key bound to their own account.
emailverify keys:post · MCP post_keys

Revoke Key — Revoke one of your own keys. Irreversible.
emailverify keys:key-id · MCP delete_keys_by_key_id

Rotate Key — Replace a key with a fresh secret, keeping its name and tier. The old key is revoked immediately, so update your clients before calling this.
emailverify keys:key-id:rotate · MCP post_keys_by_key_id_rotate

Key Usage — Usage statistics for one of your own keys.
emailverify keys:key-id:usage · MCP get_keys_by_key_id_usage

Me Recent Verifications — v59: paginated recent verifications, latest first.
emailverify me:recent-verifications · MCP get_me_recent_verifications

Me Stats — v59: quality breakdown of recent verifications + top domains.
emailverify me:stats · MCP get_me_stats

Me Usage — v59: current-user usage summary for the customer dashboard. Returns: total verifications today + this month + this year, with deltas vs previous period and a 30-day daily histogram.
emailverify me:usage · MCP get_me_usage

Me Verification Detail — v59: full /validate/checks-style detail for one verification (modal popup).
emailverify me:verification:verification-id · MCP get_me_verification_by_verification_id

Get Plans — Return all available plans and their limits.
emailverify plans · MCP get_plans

Get Usage — Get credit usage stats for the current billing period.
emailverify usage · MCP get_usage

Disposable Stats — Get stats from the last disposable domain update.
emailverify admin:disposable-stats · MCP get_admin_disposable_stats

Admin Domain Intel Stats — Aggregate stats over the entire domain_intel cache. Admin only.
emailverify admin:domain-intel:stats · MCP get_admin_domain_intel_stats

Admin Domain Learning Stats — Domain learning cache stats. Requires X-Admin-Secret.
emailverify admin:domain-learning:stats · MCP get_admin_domain_learning_stats

Trigger Reverify — Trigger re-verification of stale email records.
emailverify admin:reverify · MCP post_admin_reverify

Update Disposable — Trigger pull of fresh disposable domain lists from public sources.
emailverify admin:update-disposable · MCP post_admin_update_disposable

Update Intelligence — Refresh disposable/free provider databases from live sources.
emailverify admin:update-intelligence · MCP post_admin_update_intelligence

Admin List Users — List all users. Requires X-Admin-Secret header.
emailverify admin:users · MCP get_admin_users

Admin Upgrade User — Manually upgrade a user's plan. Requires X-Admin-Secret header.
emailverify admin:users:email:upgrade · MCP post_admin_users_by_email_upgrade

Stats — Real-time verification analytics dashboard.
emailverify stats · MCP get_stats

Domain Stats — Domain learning registry — catch-all status, email formats.
emailverify stats:domains · MCP get_stats_domains

Store Stats — Persistence layer statistics.
emailverify stats:store · MCP get_stats_store

Clerk Config — Public Clerk config — safe to expose to the browser.
emailverify auth:clerk:config · MCP get_auth_clerk_config

Clerk Me — Return the currently signed-in user (or 401). Enforces Seamless allowlist.
emailverify auth:clerk:me · MCP get_auth_clerk_me

Auth Logout — Invalidate session token.
emailverify auth:logout · MCP post_auth_logout

Auth Me — Get current user info from session token or API key.
emailverify auth:me · MCP get_auth_me

Auth Request Magic Link — Request a magic login link. Sends email with one-time sign-in URL. Rate limited to 5 requests/minute per IP.
emailverify auth:request · MCP post_auth_request

Auth Verify Post — POST handler for programmatic token verification.
emailverify auth:verify · MCP post_auth_verify

Benchmark Report Md — Return benchmark results as publishable markdown report.
emailverify benchmark:report:benchmark-id · MCP get_benchmark_report_by_benchmark_id

Benchmark Run — Run accuracy benchmark. test_emails: [{email, expected_status, notes}]
emailverify benchmark:run · MCP post_benchmark_run

Billing Checkout — Create Stripe checkout session for a plan upgrade.
emailverify billing:checkout:plan · MCP get_billing_checkout_by_plan

Billing Plans — Available subscription plans.
emailverify billing:plans · MCP get_billing_plans

Billing Signup — Create a new customer account with API key.
emailverify billing:signup · MCP post_billing_signup

Billing Stripe Webhook — Handle Stripe subscription lifecycle webhooks.
emailverify billing:stripe-webhook · MCP post_billing_stripe_webhook

Billing Usage — Get usage stats for a customer.
emailverify billing:usage:customer-id · MCP get_billing_usage_by_customer_id

Bounce Postmark — Process Postmark bounce webhook and update database.
emailverify bounce:postmark · MCP post_bounce_postmark

Bounce Sendgrid — Process SendGrid bounce events and update database.
emailverify bounce:sendgrid · MCP post_bounce_sendgrid

Bounce Ses — Process AWS SES bounce notification.
emailverify bounce:ses · MCP post_bounce_ses

Bounce Stats — Bounce statistics from feedback loop.
emailverify bounce:stats · MCP get_bounce_stats

Bulk Download — Download results as CSV. filter: all/valid/invalid/accept_all/disposable
emailverify bulk:download:job-id · MCP get_bulk_download_by_job_id

Bulk List Jobs — List recent bulk jobs.
emailverify bulk:jobs · MCP get_bulk_jobs

Bulk Status — Get real-time status and stats for a bulk job.
emailverify bulk:status:job-id · MCP get_bulk_status_by_job_id

Bulk Upload — Upload CSV/Excel/TXT list for bulk verification. Returns job_id to poll.
emailverify bulk:upload · MCP post_bulk_upload

Bulk Health Report — Get comprehensive list health report with recommendations.
emailverify bulk:job-id:report · MCP get_bulk_by_job_id_report

Catchall Classifier Stats — Catch-all ML classifier statistics.
emailverify catchall-classifier:stats · MCP get_catchall_classifier_stats

Catchall Classifier Train — Manually trigger catch-all classifier retraining.
emailverify catchall-classifier:train · MCP post_catchall_classifier_train

Resolve Catchall Endpoint — Resolve a catch-all email to valid or invalid. Runs all available signals: MS GetCredentialType, LinkedIn, Twitter, HIBP, Gravatar, format probability, domain cohort, ML classifier.
emailverify resolve-catchall · MCP post_resolve_catchall

Compliance Audit — Query the SOC 2 audit trail.
emailverify compliance:audit-trail · MCP get_compliance_audit_trail

Compliance Erase — GDPR/CCPA right-to-erasure — delete all customer data.
emailverify compliance:customer-data:customer-id · MCP delete_compliance_customer_data_by_customer_id

Compliance Summary — SOC 2 compliance summary and audit trail statistics.
emailverify compliance:summary · MCP get_compliance_summary

Db Domain Stats — Statistics for a specific domain.
emailverify db:domain:domain · MCP get_db_domain_by_domain

Db Lookup — Look up a previous verification result from the database.
emailverify db:lookup · MCP get_db_lookup

Db Search — Search verification history.
emailverify db:search · MCP get_db_search

Db Stats — Overall database statistics.
emailverify db:stats · MCP get_db_stats

Domain Deliverability — Comprehensive deliverability health check for a domain.
emailverify deliverability:domain:domain · MCP get_deliverability_domain_by_domain

Get Deliverability Score — Get 0-100 deliverability score for an email with full breakdown.
emailverify score · MCP get_score

List Cohorts — List all domains with sufficient feedback data.
emailverify cohort · MCP get_cohort

Get Domain Cohort — Get verification history and accuracy for a specific domain.
emailverify cohort:domain · MCP get_cohort_by_domain

List Domain Formats — List all known domain email formats with confidence scores.
emailverify domain-formats · MCP get_domain_formats

Scrape Domain Format — Trigger proactive scraping of a domain to learn its email format.
emailverify domain-formats:scrape · MCP post_domain_formats_scrape

Get Domain Format Endpoint — Get the known email format for a specific domain.
emailverify domain-formats:domain · MCP get_domain_formats_by_domain

Hubspot Sync — Update a HubSpot contact with email verification score.
emailverify integrations:hubspot:sync · MCP post_integrations_hubspot_sync

Salesforce Sync — Update a Salesforce Lead/Contact EmailScore__c field.
emailverify integrations:salesforce:sync · MCP post_integrations_salesforce_sync

Integrations Status — Check which integrations are configured.
emailverify integrations:status · MCP get_integrations_status

Zapier Send — Forward a verification result to a Zapier webhook URL.
emailverify integrations:zapier:send · MCP post_integrations_zapier_send

Mailchimp Webhook — Receive Mailchimp webhooks (bounce/unsubscribe/complaint).
emailverify webhooks:mailchimp · MCP post_webhooks_mailchimp

Postmark Webhook — Receive Postmark bounce/delivery webhooks.
emailverify webhooks:postmark · MCP post_webhooks_postmark

Sendgrid Webhook — Receive SendGrid event webhooks (bounce/delivered/open/click).
emailverify webhooks:sendgrid · MCP post_webhooks_sendgrid

Ses Webhook — Receive Amazon SES bounce/complaint notifications via SNS.
emailverify webhooks:ses · MCP post_webhooks_ses

Find Email Endpoint — Find the most likely email for a person at a company. Input: first_name, last_name, domain Returns ranked candidates with confidence scores.
emailverify find-email · MCP post_find_email

Find Email V2 Endpoint — Advanced email finder. >70% find rate on Fortune 1000. Uses 5 credits.
emailverify find-email:v2 · MCP post_find_email_v2

Activity Profile — Compute email activity profile from cached verification result.
emailverify activity · MCP get_activity

Record Bounce — Record a real delivery bounce. Auto-trains ML classifier.
emailverify bounce · MCP post_bounce

Record Delivered — Record a successful delivery. Adds positive training sample to ML.
emailverify delivered · MCP post_delivered

Feedback Accuracy — Verification accuracy statistics from all feedback data.
emailverify feedback:accuracy · MCP get_feedback_accuracy

Feedback Clicked — Record link click. Strongest proof of valid + active email.
emailverify feedback:clicked · MCP post_feedback_clicked

Feedback Opened — Record email open (tracking pixel). Definitive proof of valid + active email.
emailverify feedback:opened · MCP post_feedback_opened

Feedback Report — Report a verification result as correct/incorrect. Trains the classifier.
emailverify feedback:report · MCP post_feedback_report

Record Received — Mark an email as confirmed-received (appeared in inbox). Ground-truth signal: mailbox exists, person is real. Future /validate calls for this address get +25 confirmed_received bonus, bypassing catch-all penalties.
emailverify received · MCP post_received

Record Received Batch — Mark multiple emails as confirmed-received in one call. Accepts two formats: Old: {"emails": ["a@b.com", ...], "source": "inbox"} New: {"senders": [{"email": "a@b.com", "received_at": "Mon, May 2, 2026, 9:10 AM", "subject": "Re: your message"}], "source": "inbox"} received_at can be a Unix timestamp (float) or a human-readable date string. Returns count of emails recorded plus domain_inbox_stats summary.
emailverify received:batch · MCP post_received_batch

Gdpr Erase Domain — Erase all stored data for an entire domain.
emailverify gdpr:domain · MCP delete_gdpr_domain

Gdpr Erase — Right to Erasure (GDPR Art. 17 / CCPA). Deletes all stored PII for this email address. Hard bounce + spam complaint suppressions are retained for legal compliance.
emailverify gdpr:erase · MCP delete_gdpr_erase

Gdpr Export — Right of Access (GDPR Art. 15). Returns all data stored about this email address.
emailverify gdpr:export · MCP get_gdpr_export

Gdpr Purge — Purge all records older than retention policy. Run this daily. Results older than 90 days are deleted automatically.
emailverify gdpr:purge · MCP post_gdpr_purge

Gdpr Status — GDPR compliance dashboard — erasure requests, data stores, retention policy.
emailverify gdpr:status · MCP get_gdpr_status

Cache Stats Endpoint — Redis cache statistics.
emailverify cache:stats · MCP get_cache_stats

Blacklist Status — Current blacklist status for all monitored IPs and domains.
emailverify infra:blacklist-status · MCP get_infra_blacklist_status

Ip Pool Register — Register a new IP in the warmup program.
emailverify ip-pool:register · MCP post_ip_pool_register

Ip Pool Status — IP pool and warmup status.
emailverify ip-pool:status · MCP get_ip_pool_status

Regions Config — Multi-region configuration and routing rules.
emailverify regions · MCP get_regions

Regions Health — Health status of all configured regions.
emailverify regions:health · MCP get_regions_health

Regions Route — Determine which region should handle this email.
emailverify regions:route · MCP get_regions_route

Sender Domains Status — Sender domain warmup status.
emailverify sender-domains · MCP get_sender_domains

Sender Domain Register — Register a new sender domain.
emailverify sender-domains:register · MCP post_sender_domains_register

List Integrations Ep — List all configured ESP/CRM integrations.
emailverify integrations:get · MCP get_integrations

Create Integration — Configure a new ESP/CRM integration.
emailverify integrations:post · MCP post_integrations

Activecampaign Sync — Sync verification results to ActiveCampaign contacts.
emailverify integrations:activecampaign:sync · MCP post_integrations_activecampaign_sync

Klaviyo Sync — Sync verification results to Klaviyo profiles.
emailverify integrations:klaviyo:sync · MCP post_integrations_klaviyo_sync

Make Send — Send verification result to a Make (Integromat) webhook.
emailverify integrations:make:send · MCP post_integrations_make_send

Test Integration — Test an integration with a sample payload before saving.
emailverify integrations:test · MCP post_integrations_test

Delete Integration — Remove an integration.
emailverify integrations:integration-id · MCP delete_integrations_by_integration_id

Integration Events — Get recent delivery events for an integration.
emailverify integrations:integration-id:events · MCP get_integrations_by_integration_id_events

Get Domain Intel — Return all pre-cached non-SMTP intelligence for a domain. Used by dashboard to show enrichment data alongside live verification. Public endpoint (no auth) — only returns metadata, no PII.
emailverify domain-intel:domain · MCP get_domain_intel_by_domain

Get Job — Poll async bulk job status. v56: falls back to Postgres for jobs that were evicted from memory (e.g. after container restart).
emailverify jobs:job-id · MCP get_jobs_by_job_id

Get Dead Letter — v55: List emails that failed all retry attempts (dead-letter queue). Returns the email list + per-email error + attempt counts. Use POST /jobs/{id}/retry-dead-letter to re-queue them as a child job.
emailverify jobs:job-id:dead-letter · MCP get_jobs_by_job_id_dead_letter

Resume Failed Emails — Re-queue ONLY the failed emails from a previous job into a new child job. Returns the new job_id. Useful when transient errors (network, rate-limit) caused a subset of emails to fail in the original run.
emailverify jobs:job-id:resume · MCP post_jobs_by_job_id_resume

Retry Dead Letter — v55: Re-queue dead-letter emails from a previous job as a NEW child job. The child job inherits the parent's options and gets a fresh retry budget. Returns the new job_id; poll /jobs/{new_id} as usual.
emailverify jobs:job-id:retry-dead-letter · MCP post_jobs_by_job_id_retry_dead_letter

Ml Stats — ML model statistics and training status.
emailverify ml:stats · MCP get_ml_stats

Ml Stats V2 — Proprietary ML model statistics.
emailverify ml:stats:v2 · MCP get_ml_stats_v2

Ml Train — Train/retrain the proprietary deliverability model from bounce data.
emailverify ml:train · MCP post_ml_train

Verify Google Workspace — Check email existence via Google Workspace Directory API (requires service account).
emailverify verify:google-workspace · MCP get_verify_google_workspace

Verify Microsoft Graph — Check email existence via Microsoft Graph API (requires OAuth credentials).
emailverify verify:microsoft-graph · MCP get_verify_microsoft_graph

Check Activity — Email activity score — estimates how recently active the account is.
emailverify check:activity · MCP get_check_activity

Check Cross Reference — Cross-reference email against Hunter.io, Apollo, Clearbit, etc.
emailverify check:cross-reference · MCP post_check_cross_reference

Check Dkim — Check DKIM records for a domain.
emailverify check:dkim · MCP get_check_dkim

Check Dns Only — DNS/MX/SPF/DMARC lookup for a domain.
emailverify check:dns · MCP get_check_dns

Check Domain Age Endpoint — Domain age via certificate transparency logs (crt.sh).
emailverify check:domain-age · MCP get_check_domain_age

Check Format Probability — Score format probability for this email at its domain.
emailverify check:format-probability · MCP get_check_format_probability

Linkedin Name Check Endpoint — Check if the person's name from an email appears on LinkedIn at that company. Extracts first/last name from the email local part, then searches: 1. LinkedIn people search (direct) 2. LinkedIn company people page 3. LinkedIn profile slug inference (tries common patterns) 4. Google search: site:linkedin.com "John Smith" "Stripe" 5. Bing search fallback 6. DuckDuckGo fallback Returns `target_name_linkedin_found: true` when the person is confirmed to work at the company — a strong secondary signal for catch-all validation. Only works with name-pattern emails (first.last, first_last, f.last).
emailverify check:linkedin-name · MCP get_check_linkedin_name

Mine Emails Endpoint — Mine public sources for real emails at a domain to build format DB.
emailverify check:mine-emails · MCP post_check_mine_emails

Check Ms Credential Endpoint — Microsoft GetCredentialType — confirms M365 user existence.
emailverify check:ms-credential · MCP get_check_ms_credential

Check Mx Intel — Full MX infrastructure analysis — PTR, hosting provider, geo, chain.
emailverify check:mx-intel · MCP get_check_mx_intel

Check Name Realism — Score how realistic a name this email represents (0-100).
emailverify check:name-realism · MCP get_check_name_realism

Check Pattern — Pattern analysis — human-likeness score, name detection, random string detection.
emailverify check:pattern · MCP get_check_pattern

Check Rbl Endpoint — Check an MX host's IP against all RBL blacklists.
emailverify check:rbl · MCP get_check_rbl

Scrape Domain Endpoint — Deep web crawl with anti-detection stack (curl_cffi → cloudscraper → Playwright → Wayback). Returns four types of intelligence per domain: **Email detection** — emails found, extraction method, page source URL, surrounding context **Email pattern** — dominant format (first.last / flast / f.last), confidence, distribution, examples **Name detection** — people found with first/last name, job title, source page, associated email/phone **Phone detection** — phones found, normalized E.164 format, page source, country code, toll-free flag All results are cached 7 days per domain. Anti-detection: TLS fingerprint impersonation, Cloudflare bypass, headless Chrome stealth, Wayback fallback.
emailverify check:scrape-domain · MCP get_check_scrape_domain

Suppression Add — Add email to suppression list.
emailverify suppression:add · MCP post_suppression_add

Suppression Check — Check if email is on the suppression list.
emailverify suppression:check · MCP get_suppression_check

Suppression Stats — Suppression list statistics.
emailverify suppression:stats · MCP get_suppression_stats

Suppression Remove — Remove email from suppression list.
emailverify suppression:email · MCP delete_suppression_by_email

Greylist
emailverify greylist · MCP get_greylist

Health
emailverify health · MCP get_health

Ips
emailverify ips · MCP get_ips

Senders
emailverify senders · MCP get_senders

Webhook Stats
emailverify webhooks:stats · MCP get_webhooks_stats

Dedup Emails — Deduplicate a list of emails (Gmail dots, plus addressing, case normalization).
emailverify utils:dedup · MCP post_utils_dedup

Validate With Score — Verify email AND return 0-100 deliverability score in one call.
emailverify validate:with-score · MCP get_validate_with_score

Validate Get — Full email verification — all signal layers.
emailverify validate:get · MCP get_validate

Validate Post — Full verification via POST with all options.
emailverify validate:post · MCP post_validate

Validate Bulk — Sync bulk verification up to 100 emails.
emailverify validate:bulk · MCP post_validate_bulk

Validate Bulk Async — Async bulk verification — returns job_id immediately, poll /jobs/{id}.
emailverify validate:bulk:async · MCP post_validate_bulk_async

Validate Bulk Turbo — v53/#3: Turbo bulk path — cache-first + domain coalescing + 50× concurrency. Pipeline: 1. Look up all N emails in cache. Hits return immediately (~50ms each). 2. Group cache misses by domain. For each unique domain, run domain-level checks ONCE (MX/RBL/DBL/catch-all) and share the result across all emails at that domain. 3. Final per-email check (syntax + SMTP + pattern) runs concurrently at 50× parallelism, gated by per-domain rate limits. Speedup is roughly proportional to (cache hit rate + domain duplication ratio). A typical 100K customer list with 3K unique domains and 60% cache hit rate finishes in 3-8 minutes instead of 8+ hours. Returns: same shape as /validate/bulk (synchronous, results array). Limit: 5000 emails per call (use /validate/bulk/async with webhook_url for larger).
emailverify validate:bulk:turbo · MCP post_validate_bulk_turbo

Validate Checks Get — v52: Clean per-check results, ideal for direct DB insert. Returns: • summary — score/grade/can_send/status/primary_risk • checks — ~45 normalized result strings (smtp: valid|invalid|accept_all|...) • score_breakdown — which checks moved the deliverability score
emailverify validate:checks:get · MCP get_validate_checks

Validate Checks Post — v52: Clean per-check results via POST. See GET /validate/checks for shape.
emailverify validate:checks:post · MCP post_validate_checks

Validate Fast — v53/#5 + v54: Sub-100ms p95 cache-only lookup. Respects per-row TTL by default: • catch-all results cached 12 months (stable behavior) • valid/invalid results cached 7 days (mailboxes change) • unknown/errors cached 1 day (re-probe quickly) Pass max_age_hours to enforce a tighter window. Returns 404 if no fresh cached result — call /validate for a fresh verification.
emailverify validate:fast · MCP get_validate_fast

Validate Quick — Instant check — syntax + DNS + intelligence only (no SMTP, <100ms).
emailverify validate:quick · MCP get_validate_quick

Validate Syntax Only — Pure syntax check — RFC 5321/5322 compliance, typo detection, IDN. No network.
emailverify validate:syntax · MCP get_validate_syntax

Breach Intelligence Endpoint — Multi-source breach intelligence (HIBP + optional SpyCloud/Dehashed).
emailverify verify:breach-intel · MCP get_verify_breach_intel

Catchall Resolve V2 — Resolve catch-all domains using multi-signal triangulation. Uses LinkedIn, GitHub, website scraping, historical DB, format probability.
emailverify verify:catchall-resolve · MCP post_verify_catchall_resolve

Verify Quick — Sub-50ms email verification for form validation. Returns instantly with cached/syntax signals. Queues full SMTP verification in background.
emailverify verify:quick · MCP get_verify_quick

Verify Status — Poll for result of a pending quick verification.
emailverify verify:status:verification-id · MCP get_verify_status_by_verification_id

Check Typo — Detect email typos and return correction suggestion.
emailverify verify:typo · MCP get_verify_typo