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

Try it

Credentials

Runs against your live account — 10 credits will be deducted.

This endpoint requires an API key. Enter one above to run it — create a key if you don't have one. Your key is used only for this request and is never stored.

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"}'
1{2  "jobId": "69d78ba337e519a86c186262"3}
GET Auth

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. Jobs are owner-scoped — the key must belong to the account that started the job.

Path Parameters

jobIdstring*

Job ID from the find request

Try it

Credentials

This endpoint requires an API key. Enter one above to run it — create a key if you don't have one. Your key is used only for this request and is never stored.

1curl -X GET "https://api.verifox.ai/v1/email-finder/find_abc123" \2  -H "X-API-Key: vfx_your_api_key"
1{2  "_id": "69d78ba337e519a86c186262",3  "status": "completed",4  "bestMatch": {5    "email": "john.doe@stripe.com",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.

Try it

Credentials

This endpoint requires an API key. Enter one above to run it — create a key if you don't have one. Your key is used only for this request and is never stored.

1curl -X GET "https://api.verifox.ai/v1/email-finder/history" \2  -H "X-API-Key: vfx_your_api_key"
1{2  "searches": [3    {4      "_id": "69d78b785ecba78539fd4205",5      "name": "John Doe",6      "domain": "stripe.com",7      "email": "john.doe@stripe.com",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

Try it

Credentials

This endpoint requires an API key. Enter one above to run it — create a key if you don't have one. Your key is used only for this request and is never stored.

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": "john.doe@stripe.com", "confidence": 95, "verified": true}'
1{ "_id": "69d78b785ecba78539fd4205" }
DELETE Auth

Clear History

/v1/email-finder/history

Delete all saved searches from your history.

Try it

Credentials

This permanently deletes every saved search on the account the key belongs to. There is no undo.

This endpoint requires an API key. Enter one above to run it — create a key if you don't have one. Your key is used only for this request and is never stored.

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