agntdata Lead APIspost/people/email-finder

Find 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