Email Finder API

Find a verified professional email from first name, last name, and company domain.

How it works

1. You send first_name, last_name, and domain.
2. VeriMails checks the supplied name and domain for a verified person-level mailbox.
3. A result is returned only after live verification.
4. If a verified mailbox cannot be confirmed, the API returns not_found or catch_all.
5. For person lookups, VeriMails returns a verified person-level address when one can be confirmed.

Find one email

curl -X POST https://verimails.com/api/find-email \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Jane","last_name":"Doe","domain":"company.com"}'

{
  "found": true,
  "email": "jane.doe@company.com",
  "status": "found",
  "confidence": 0.95,
  "elapsed_ms": 420
}

Find up to 100 emails synchronously

Use the synchronous bulk endpoint for small batches. Larger files should use the CSV flow below.

curl -X POST https://verimails.com/api/find-email/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "leads": [
      {"first_name":"Jane","last_name":"Doe","domain":"company.com"},
      {"first_name":"Sam","last_name":"Lee","domain":"example.com"}
    ]
  }'

CSV Email Finder

Upload a CSV when you need to find emails at scale. The CSV must include first name, last name, and domain columns. Supported aliases include firstname, lastname, company_domain, website, and company_website.

first_name,last_name,domain
Jane,Doe,company.com
Sam,Lee,example.com

curl -X POST https://verimails.com/api/find-email/csv \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv"

curl https://verimails.com/api/find-email/csv/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://verimails.com/api/find-email/csv/JOB_ID/download \
  -H "Authorization: Bearer YOUR_API_KEY" -o finder_results.csv

The output CSV appends found_email, finder_status, finder_confidence, and finder_elapsed_ms.

Statuses