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

# Find Email

> Look up email addresses for selected people at one outreach prospect.

Pass the prospect `id` and `peopleIds` from [Outreach Contacts](/docs/api-reference/endpoints/outreach-contacts#list-a-prospects-people). To look up people across multiple prospects in one request, use [Find Emails in Bulk](/docs/api-reference/endpoints/outreach-find-emails-bulk).

The `202` response reports `queued`, `queuedPeopleIds`, `skipped`, and `creditsCharged`. `queuedPeopleIds` are person IDs, not worker job IDs. Poll [Outreach Contacts](/docs/api-reference/endpoints/outreach-contacts#list-a-prospects-people) while a queued person's `status` is `enriching`; the result is reflected in their `email` and terminal status.

The request charges 10 AI credits per eligible person queued. People already looked up or mid-lookup are skipped without a charge. Lookups that cannot be started or finish without an address are refunded, so `creditsCharged` is the upfront total, not necessarily the final cost.


## OpenAPI

````yaml POST /v3/outreach/prospects/{id}/people/enrich
openapi: 3.0.0
info:
  title: SnowSEO API
  description: API documentation for SnowSEO
  version: 1.0.0
servers:
  - url: https://api.snowseo.com
    description: Production server
security: []
tags:
  - name: Keywords
    description: Keyword research and suggestion end-points
  - name: Onboarding
    description: Brand onboarding and strategy end-points
  - name: Brands
    description: Brand management end-points
  - name: Organizations
    description: Organization and member end-points
  - name: Integrations
    description: Google Search Console and other integrations
  - name: Utilities
    description: Common utility end-points like screenshots and uploads
externalDocs:
  url: https://snowseo.com/docs
  description: Find more info here
paths:
  /v3/outreach/prospects/{id}/people/enrich:
    post:
      tags:
        - Outreach
      summary: Buy email addresses for a prospect's people
      description: >-
        Look up the real email addresses of people already found at a site, so
        they can be written to. Costs credits per person actually looked up. Get
        the people IDs from outreach_prospect_people. Dropped server-side at no
        cost: anyone already enriched, mid-lookup, or whose status is no_email
        because the provider already looked and found none. A retry is therefore
        safe and never double-charges.
      operationId: enrichOutreachProspectPeople
      parameters:
        - schema:
            type: string
          in: path
          name: id
          required: true
          description: Prospect ID.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - peopleIds
              properties:
                peopleIds:
                  type: array
                  minItems: 1
                  maxItems: 2000
                  items:
                    type: string
                  description: >-
                    People IDs from outreach_prospect_people, all on this
                    prospect.
      responses:
        '202':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  queued:
                    type: integer
                  queuedPeopleIds:
                    type: array
                    items:
                      type: string
                    description: >-
                      People whose email lookups were accepted. Read their
                      terminal statuses from the people list; these are not
                      worker job IDs.
                  skipped:
                    type: integer
                  creditsCharged:
                    type: number
                additionalProperties: true

````