Find an Email

Find a person's email address from their name and company domain. The finder tries the common email formats and verifies each one live, returning the first that checks out.

POST /api/v1/find

Request

Field	Type	Required	Description
first_name	string	Yes	The person's first name.
last_name	string	Yes	The person's last name.
domain	string	Yes	The company domain, for example acme.com.

Examples

cURL

curl https://app.bluauto.io/api/v1/find \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"first_name":"John","last_name":"Doe","domain":"acme.com"}'

Python

import requests

resp = requests.post(
    "https://app.bluauto.io/api/v1/find",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"first_name": "John", "last_name": "Doe", "domain": "acme.com"},
    timeout=120,
)
print(resp.json())   # { result, label, email, domain, mx }

HTTP

POST /api/v1/find HTTP/1.1
Host: app.bluauto.io
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{"first_name":"John","last_name":"Doe","domain":"acme.com"}

Response

{
  "result": "found",
  "label": "Found",
  "email": "john.doe@acme.com",
  "domain": "acme.com",
  "mx": "Google"
}

Field	Description
result	The machine value. See result values.
label	The same wording shown in the app.
email	The verified address when result is found, otherwise empty.
domain	The domain that was searched.
mx	The mail provider behind the domain, or null.

For the full list of result values and what they mean, see Responses & Status Values.