/people/email-finderFind a person's professional email
People — Email
Cost / request
$0.01
Response format
JSON
Protocol
REST
About this endpoint
Find a verified professional email for a named person at a known company. Pass either a full name (or first+last) plus a company domain/name, or a LinkedIn URL/handle. agntdata waterfalls cheapest-first across upstream email-finder providers and stops once an email is returned (or your `max_cost_cents` budget is reached).
Use cases
Resolve names + companies into deliverable work emails for outbound
Enrich CRM contact records that only have names
Power AI sales agents that need a contact email before sending
Parameters
bodyRequest Bodyrequired
Content type: application/json
Responses
Email finder result.
{
"type": "object",
"required": [
"success",
"data"
],
"properties": {
"success": {
"type": "boolean",
"enum": [
true
]
},
"data": {
"$ref": "#/components/schemas/PeopleEmailFinderResponse"
},
"meta": {
"$ref": "#/components/schemas/AgntMeta"
}
}
}Agent / Developer Schema
Machine-readable formats for integrating this endpoint into AI agents and toolchains.
{
"operationId": "people_email_finder",
"method": "post",
"path": "/people/email-finder",
"summary": "Find a person's professional email",
"description": "Find a verified professional email for a person at a company. 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`). LinkedIn URL/handle is not currently supported here — if that is all you have, call `/people/enrich` first with `identifiers.linkedin_url` to resolve name + domain, then call this endpoint. 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`.",
"parameters": [],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PeopleEmailFinderRequest"
},
"example": {
"first_name": "Patrick",
"last_name": "Collison",
"domain": "stripe.com",
"max_cost_cents": 2.5
}
}
}
},
"responses": [
{
"statusCode": "200",
"description": "Email finder result.",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"success",
"data"
],
"properties": {
"success": {
"type": "boolean",
"enum": [
true
]
},
"data": {
"$ref": "#/components/schemas/PeopleEmailFinderResponse"
},
"meta": {
"$ref": "#/components/schemas/AgntMeta"
}
}
}
}
}
},
{
"statusCode": "400",
"description": "Validation error."
},
{
"statusCode": "401",
"description": "Unauthorized — missing or invalid API key."
},
{
"statusCode": "402",
"description": "Insufficient credits."
},
{
"statusCode": "429",
"description": "Rate limit exceeded."
},
{
"statusCode": "5XX",
"description": "Upstream or internal error."
}
]
}Pricing
$0.01per successful request
Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.
Related endpoints
Start using this endpoint
Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.
email finder APIname to email APIprofessional email lookupB2B email finderlead enrichment APIemail finder APIemail verifier API