API Reference · v1

Email Finder

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

Base URLapi.verifox.ai/v1AuthX-API-Key headerRate limit60 req/minFormatJSON over HTTPSLatency~380ms

Get Started Free
POST Auth 10 cr

Find Email

/v1/email-finder

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

firstNamestring*

Person's first name

lastNamestring*

Person's last name

domainstring*

Company domain (e.g. stripe.com)

middleNamestringopt

Middle name for better accuracy

1curl -X POST "https://api.verifox.ai/v1/email-finder" \2  -H "X-API-Key: vfx_your_api_key" \3  -H "Content-Type: application/json" \4  -d '{"firstName": "John", "lastName": "Doe", "domain": "stripe.com"}'
200 - Response
1{2  "jobId": "69d78ba337e519a86c186262"3}
GET

Get Job Status

/v1/email-finder/:jobId

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

Path Parameters

jobIdstring*

Job ID from the find request

1curl -X GET "https://api.verifox.ai/v1/email-finder/find_abc123" \2  -H "X-API-Key: vfx_your_api_key"
200 - Response
1{2  "_id": "69d78ba337e519a86c186262",3  "status": "completed",4  "bestMatch": {5    "email": "[email protected]",6    "reachable": "safe"7  },8  "score": 92,9  "createdAt": "2026-03-31T10:30:00Z",10  "completedAt": "2026-03-31T10:30:15Z"11}
GET Auth

Get Search History

/v1/email-finder/history

Retrieve your past email finder searches.

1curl -X GET "https://api.verifox.ai/v1/email-finder/history" \2  -H "X-API-Key: vfx_your_api_key"
200 - Response
1{2  "searches": [3    {4      "_id": "69d78b785ecba78539fd4205",5      "name": "John Doe",6      "domain": "stripe.com",7      "email": "[email protected]",8      "confidence": 95,9      "verified": true,10      "score": null,11      "createdAt": "2026-03-31T10:30:00Z"12    }13  ]14}
POST Auth

Save Search

/v1/email-finder/history

Save an email finder result to your search history.

Request Body

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

1curl -X POST "https://api.verifox.ai/v1/email-finder/history" \2  -H "X-API-Key: vfx_your_api_key" \3  -H "Content-Type: application/json" \4  -d '{"name": "John Doe", "domain": "stripe.com", "email": "[email protected]", "confidence": 95, "verified": true}'
200 - Response
1{ "_id": "69d78b785ecba78539fd4205" }
DELETE Auth

Clear History

/v1/email-finder/history

Delete all saved searches from your history.

1curl -X DELETE "https://api.verifox.ai/v1/email-finder/history" \2  -H "X-API-Key: vfx_your_api_key"
200 - Response
1{ "ok": true }