> ## 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 Emails in Bulk

> Look up email addresses for selected people across outreach prospects in one request.

Pass `peopleIds` from [List every person](/docs/api-reference/endpoints/outreach-contacts#list-every-person). To restrict the lookup to one prospect, use [Find Outreach Email](/docs/api-reference/endpoints/outreach-find-email).

The `202` response reports `queued`, `queuedPeopleIds`, `skipped`, and `creditsCharged`. `queuedPeopleIds` are person IDs, not worker job IDs. Poll [List every person](/docs/api-reference/endpoints/outreach-contacts#list-every-person) while queued people have `status` `enriching`; their rows report the eventual address or failure.

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/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/people/enrich:
    post:
      tags:
        - Outreach
      summary: Buy email addresses across prospects
      description: >-
        Look up addresses for people selected across the team's prospects.
        Charges only for eligible people and refunds any lookup that cannot be
        started or returns no address.
      operationId: enrichOutreachPeople
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - peopleIds
              properties:
                peopleIds:
                  type: array
                  minItems: 1
                  maxItems: 2000
                  items:
                    type: string
      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

````