Find a person's professional email

Find a verified professional email for a person at a company. Use this when you have a NAME + COMPANY (most common case). Identifier fields are at the TOP LEVEL of the body (NOT inside an identifiers object): first_name + last_name (or full_name) plus domain (or company / company_name); alternatively pass linkedin_url or linkedin_handle. agntdata waterfalls cheapest-first across providers until an email is returned (or your max_cost_cents budget is exhausted). If you already know the email and want to look up other fields, use /people/enrich instead with identifiers.email.

POST /v1/data/agnt/people/email-finder

Find a person's professional email

cURL

curl --request POST \
  --url https://api.agntdata.dev/v1/data/agnt/people/email-finder \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "Patrick",
  "last_name": "Collison",
  "domain": "stripe.com",
  "max_cost_cents": 2.5
}
'

200

{
  "success": true,
  "data": {
    "email": "<string>",
    "status": "valid",
    "score": 123,
    "sources": "<unknown>",
    "position": "<string>",
    "full_name": "<string>"
  },
  "meta": {
    "costCents": 123,
    "purchasedBalanceCents": 123,
    "subscriptionRemainingCents": 123,
    "cached": true,
    "latencyMs": 123,
    "priceRange": {
      "minCents": 123,
      "maxCents": 123
    },
    "budgetCents": 123,
    "budgetCentsPerRecord": 123,
    "providersAttempted": 123,
    "fieldsReturned": [
      "<string>"
    ],
    "fieldsMissing": [
      "<string>"
    ],
    "records": 123
  }
}

Authorizations

Authorization · string · header · required

Bearer token. Pass your agntdata API key as: Authorization: Bearer agnt_live_...

Body

application/json

Identifier fields are TOP-LEVEL (NOT nested under identifiers). Provide either: (a) name + company — first_name+last_name (or full_name) plus domain (or company/company_name); or (b) linkedin_url/linkedin_handle alone.

first_name · string

Person's first name. Pair with last_name (or use full_name instead).

Minimum string length: 1

last_name · string

Person's last name. Pair with first_name.

Minimum string length: 1

full_name · string

Person's full name — alternative to first_name + last_name.

Minimum string length: 1

domain · string

Company root domain (e.g. "tesla.com"). Strongest company signal.

Minimum string length: 1

company · string

Company name (alias of company_name). Use when domain is unknown.

Minimum string length: 1

company_name · string

Company name (alias of company).

Minimum string length: 1

linkedin_url · string<uri>

Full LinkedIn profile URL — supplies both person and company in one field.

linkedin_handle · string

LinkedIn vanity handle (the slug from the profile URL).

Minimum string length: 1

max_cost_cents · number

Required range: x >= 0

Response

200

application/json

Email finder result.

success · enum<boolean> · required

Available options: true

data · object · required

Show child attributes

meta · object

Show child attributes