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

# List a prospect's addresses

> Every email address found for one prospect, best first.

Every address found for one prospect, best first. **The `id` of a row here is the `prospectEmailId`** that [Queue pitches](https://snowseo.com/docs/api-reference/endpoints/outreach-queue-pitches.md) and [Draft a pitch](https://snowseo.com/docs/api-reference/endpoints/outreach-draft-pitch.md) take.

| Field | Description |
| - | - |
| `id` | The `prospectEmailId` |
| `prospectId` | The prospect it belongs to |
| `peopleId` | The person the address belongs to, or `null` when it is not tied to one |
| `email` | The address |
| `name` / `role` | Who it belongs to |
| `countryCode` / `location` | The person's ISO country code and location, when the provider sent them |
| `verifiedStatus` | `valid`, `catchall`, `greylisted`, `unknown`, `invalid` |
| `confidence` | 0-100 |
| `sourceLayer` | The vendor that supplied the address, such as `cleanlist` or `rocketreach` |
| `isPrimary` | The address to use for the person it belongs to |
| `createdAt` / `updatedAt` | When the row was added and last changed |

Rows are sorted by `confidence`, highest first.

### What `verifiedStatus` means

| Value | Meaning | Safe to send? |
| - | - | - |
| `valid` | Their mail server confirmed the inbox exists | Yes |
| `catchall` | The server accepts mail to any address, so this exact inbox is unproven | Usually, expect the odd bounce |
| `greylisted` | The server asked us to check back later, so the check did not finish | Retry later |
| `unknown` | Their mail server could not be reached, or the address has not been checked yet (the default) | Your call |
| `invalid` | The server rejected the address outright | **No** - it will bounce |

> [!WARNING]
>
> Sending to `invalid` addresses is the fastest way to damage a sending domain's reputation, and a held-back reputation affects every email you send afterwards. Filter them out before queueing.


## OpenAPI

````yaml GET /v3/outreach/prospects/{id}/emails
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:
  - bearerAuth: []
  - apiKey: []
externalDocs:
  url: https://snowseo.com/docs
  description: Find more info here
paths:
  /v3/outreach/prospects/{id}/emails:
    get:
      tags:
        - Outreach
      summary: List a prospect's contact addresses
      description: >-
        Every address found for one prospect, best first, with its verification
        status and confidence. The id of a row here is the prospectEmailId that
        outreach_queue_emails and outreach_draft_email take.
      operationId: listOutreachProspectEmails
      parameters:
        - schema:
            type: string
          in: path
          name: id
          required: true
          description: Prospect ID.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  emails:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        email:
                          type: string
                        name:
                          type: string
                          nullable: true
                        role:
                          type: string
                          nullable: true
                        countryCode:
                          type: string
                          nullable: true
                          description: >-
                            The owner's ISO country code, when the provider sent
                            one.
                        location:
                          type: string
                          nullable: true
                        verifiedStatus:
                          type: string
                        confidence:
                          type: number
                        isPrimary:
                          type: boolean
                      additionalProperties: true
                additionalProperties: true
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your SnowSEO API key (sk_...).
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.