Search Person

Search for a B2B contact by name + company/domain.

Returns a profile from the database if found, or predicted email patterns with confidence scores if not found. Costs 0 credits (monthly lookup limit only).

POST /api/v1/email-finder/search

Search Person

cURL

curl --request POST \
  --url https://api.example.com/api/v1/email-finder/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "company": "<string>",
  "domain": "<string>"
}
'

200

{
  "found": true,
  "person": {},
  "prediction": {},
  "verification": {},
  "confidence_breakdown": {},
  "source": "none",
  "error": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name · string · required

Full name to search for

Required string length: 2 - 200

company · string | null

Company name (optional if domain provided)

Maximum string length: 200

domain · string | null

Company domain (optional if company provided)

Maximum string length: 253

Response

200

application/json

Successful Response

found · boolean · required

person · Person · object

prediction · Prediction · object

verification · Verification · object

confidence_breakdown · Confidence Breakdown · object

source · string · default: none

error · string | null