APIEmail Finder

Email Finder

/v1/email-finder·5 endpoints

Find anyone's professional email address using their name and company domain. Uses smart permutation and SMTP verification.

POST/v1/email-finderAuth1cr

Find Email

Start an email finder job. Generates all possible email permutations for the given name + domain, then verifies each via SMTP. Returns a job ID for polling.

Request Body

Parameter	Type	Required	Description
`firstName`	`string`	Required	Person's first name
`lastName`	`string`	Required	Person's last name
`domain`	`string`	Required	Company domain (e.g. stripe.com)
`middleName`	`string`	Optional	Middle name for better accuracy

firstNamestring*

Person's first name

lastNamestring*

Person's last name

domainstring*

Company domain (e.g. stripe.com)

middleNamestringopt

Middle name for better accuracy

Request

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

Get Job Status

Poll the status of an email finder job. When status is 'completed', the bestMatch field contains the most likely email address.

Path Parameters

Parameter	Type	Required	Description
`jobId`	`string`	Required	Job ID from the find request

jobIdstring*

Job ID from the find request

Request

curl -X GET "https://api.verifox.ai/v1/email-finder/find_abc123" \
  -H "X-API-Key: vfx_your_api_key"

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"
}

GET/v1/email-finder/historyAuth

Get Search History

Retrieve your past email finder searches.

No parameters

Request

curl -X GET "https://api.verifox.ai/v1/email-finder/history" \
  -H "X-API-Key: vfx_your_api_key"

Response

{
  "searches": [
    {
      "_id": "69d78b785ecba78539fd4205",
      "name": "John Doe",
      "domain": "stripe.com",
      "email": "john.doe@stripe.com",
      "confidence": 95,
      "verified": true,
      "score": null,
      "createdAt": "2026-03-31T10:30:00Z"
    }
  ]
}

POST/v1/email-finder/historyAuth

Save Search

Save an email finder result to your search history.

Request Body

Parameter	Type	Required	Description
`name`	`string`	Required	Person's full name
`domain`	`string`	Required	Company domain
`email`	`string \| null`	Required	Found email (null if not found)
`confidence`	`number \| null`	Required	Confidence score
`verified`	`boolean`	Optional · false	Whether email was SMTP verified
`score`	`number \| null`	Optional · null	Email quality score

namestring*

Person's full name

domainstring*

Company domain

emailstring | null*

Found email (null if not found)

confidencenumber | null*

Confidence score

verifiedbooleanopt

Whether email was SMTP verified

scorenumber | nullopt

Email quality score

Request

curl -X POST "https://api.verifox.ai/v1/email-finder/history" \
  -H "X-API-Key: vfx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "John Doe", "domain": "stripe.com", "email": "john.doe@stripe.com", "confidence": 95, "verified": true}'

Response

{ "_id": "69d78b785ecba78539fd4205" }

DELETE/v1/email-finder/historyAuth

Clear History

Delete all saved searches from your history.

No parameters

Request

curl -X DELETE "https://api.verifox.ai/v1/email-finder/history" \
  -H "X-API-Key: vfx_your_api_key"

Response

{ "ok": true }