> ## Documentation Index
> Fetch the complete documentation index at: https://agnt.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Find a person's professional email

> 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`.



## OpenAPI

````yaml /openapi/agnt.openapi.json post /v1/data/agnt/people/email-finder
openapi: 3.0.0
info:
  title: agntdata Lead APIs
  description: >-
    Internal lead enrichment API surface that orchestrates multiple upstream
    data providers behind a single endpoint per use case. Use these endpoints to
    find and verify professional emails, find mobile phone numbers, enrich and
    search people and companies, discover companies, list a domain's email
    addresses, run bulk people/company enrichments, and fetch company
    intelligence (funding/competitors/technographics). Provider names are never
    returned — agntdata picks the cheapest providers that can fulfill the
    requested fields and merges results.
  version: 1.0.0
  contact:
    name: agntdata
    url: https://agntdata.dev
servers:
  - url: https://api.agntdata.dev
    description: agntdata API
security:
  - ApiKeyAuth: []
tags:
  - name: People — Email
    description: Find, verify, and enrich professional email addresses.
  - name: People — Enrich
    description: Enrich people with structured profile data.
  - name: People — Mobile
    description: Find mobile phone numbers from a profile.
  - name: People — Search
    description: Search the people graph by structured filters.
  - name: Companies — Discover
    description: Discover companies that match a set of criteria.
  - name: Companies — Email
    description: List the email addresses found for a company domain.
  - name: Companies — Enrich
    description: Enrich companies with firmographic data.
  - name: Companies — Search
    description: Search the company graph by structured filters.
  - name: Companies — Intelligence
    description: Funding, competitors, and technographics for a company.
paths:
  /v1/data/agnt/people/email-finder:
    post:
      tags:
        - People — Email
      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`.
      operationId: people_email_finder
      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:
        '200':
          description: Email finder result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Post_agnt_people_email_finder_Response'
        '400':
          description: Validation error.
        '401':
          description: Unauthorized — missing or invalid API key.
        '402':
          description: Insufficient credits.
        '429':
          description: Rate limit exceeded.
        5XX:
          description: Upstream or internal error.
      security:
        - ApiKeyAuth: []
components:
  schemas:
    PeopleEmailFinderRequest:
      type: object
      properties:
        first_name:
          type: string
          minLength: 1
          description: >-
            Person's first name. Pair with `last_name` (or use `full_name`
            instead).
        last_name:
          type: string
          minLength: 1
          description: Person's last name. Pair with `first_name`.
        full_name:
          type: string
          minLength: 1
          description: Person's full name — alternative to `first_name` + `last_name`.
        domain:
          type: string
          minLength: 1
          description: Company root domain (e.g. "tesla.com"). Strongest company signal.
        company:
          type: string
          minLength: 1
          description: Company name (alias of `company_name`). Use when domain is unknown.
        company_name:
          type: string
          minLength: 1
          description: Company name (alias of `company`).
        max_cost_cents:
          type: number
          minimum: 0
      additionalProperties: false
      description: >-
        Identifier fields are TOP-LEVEL (NOT nested under `identifiers`).
        Provide a name (`first_name`+`last_name` or `full_name`) AND a company
        (`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.
    Post_agnt_people_email_finder_Response:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          enum:
            - true
        data:
          $ref: '#/components/schemas/PeopleEmailFinderResponse'
        meta:
          $ref: '#/components/schemas/AgntMeta'
    PeopleEmailFinderResponse:
      type: object
      properties:
        email:
          type: string
          nullable: true
        status:
          type: string
          enum:
            - valid
            - accept_all
            - unknown
            - invalid
        score:
          type: number
          nullable: true
        sources: {}
        position:
          type: string
          nullable: true
        full_name:
          type: string
          nullable: true
      required:
        - email
        - status
      additionalProperties: false
    AgntMeta:
      type: object
      properties:
        costCents:
          type: number
        purchasedBalanceCents:
          type: number
        subscriptionRemainingCents:
          type: number
        cached:
          type: boolean
        latencyMs:
          type: number
        priceRange:
          type: object
          properties:
            minCents:
              type: number
            maxCents:
              type: number
          required:
            - minCents
            - maxCents
          additionalProperties: false
        budgetCents:
          type: number
        budgetCentsPerRecord:
          type: number
        providersAttempted:
          type: number
        fieldsReturned:
          type: array
          items:
            type: string
        fieldsMissing:
          type: array
          items:
            type: string
        records:
          type: number
      required:
        - costCents
        - purchasedBalanceCents
        - subscriptionRemainingCents
        - cached
        - latencyMs
      additionalProperties: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Bearer token. Pass your agntdata API key as: Authorization: Bearer
        agnt_live_...

````