POST/find

Find an email

Generates common address permutations, checks for a catch-all domain, and returns the first address that can be verified.

Request

Authenticate with a bearer token and send the following request.

cURL

curl --request POST \
  --url https://api.mailverifio.com/v1/find \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "firstName": "Ada",
    "lastName": "Lovelace",
    "domain": "example.com"
  }'

Find with a company name

If the domain is unknown, companyName is converted to a likely .com domain before patterns are tested.

cURL

curl --request POST \
  --url https://api.mailverifio.com/v1/find \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "firstName": "Ada",
    "lastName": "Lovelace",
    "companyName": "Example Labs"
  }'

Body parameters

Name	Type	Required	Description
`firstName`	`string`	Yes	Person’s first name.
`lastName`	`string`	Yes	Person’s last name.
`domain`	`string`	One of domain/companyName	Known company domain, such as example.com.
`companyName`	`string`	One of domain/companyName	Company name used to infer a likely .com domain.

JSON body

{
  "firstName": "Ada",
  "lastName": "Lovelace",
  "domain": "example.com"
}

Example response

json

{
  "success": true,
  "data": {
    "status": "found",
    "email": "ada.lovelace@example.com",
    "details": "Found valid email at example.com",
    "checked_count": 7,
    "patterns_tested": [
      "ada@example.com",
      "adalovelace@example.com",
      "ada.lovelace@example.com"
    ]
  },
  "meta": {
    "requestId": "req_example",
    "duration": 12500,
    "version": "v1"
  }
}

Operational notes

A known domain produces more reliable results than an inferred company domain.
Catch-all domains are skipped because a specific mailbox cannot be confirmed.
The finder checks candidates in batches of five and can take 5–30 seconds.