> ## 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 individual messages

> Every message sent and received, one row each.

Every message sent and received, one row each, grouped by conversation (conversations in descending ID order, messages oldest first inside each). Unsent drafts are excluded. This is the message-level view; the [conversation list](https://snowseo.com/docs/api-reference/endpoints/outreach-sending-conversations-list.md) groups the same data and is usually the better read. Returns 25 messages per page by default; pass `page`/`pageSize`, or `pageSize=all` for every message. `search` matches the subject, sender and recipient name or email, and prospect domain before paging.

> [!NOTE]
>
> Inbound mail only exists for mailboxes connected with reading settings. Mailboxes connected through an OAuth provider are send-only, so an empty reply list is not necessarily a bug.


## OpenAPI

````yaml GET /v3/outreach/outbox/messages
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/outbox/messages:
    get:
      tags:
        - Outreach
      summary: List individual outreach messages
      description: >-
        Every message sent or received, one row each, grouped by conversation
        (newest conversation first, messages oldest first within it), 25 per
        page by default (pageSize=all for every message). This is the
        message-level view; outreach_inbox_threads groups the same data into
        conversations and is usually the better read.
      operationId: listOutreachMessages
      parameters:
        - schema:
            type: integer
          in: query
          name: page
          required: false
          description: 1-based page. Default 1.
        - schema:
            type: string
          in: query
          name: pageSize
          required: false
          description: >-
            Rows per page (max 1000), or 'all'. Every response reports total and
            totalPages.
        - schema:
            type: integer
            minimum: 1
          in: query
          name: limit
          required: false
          description: Optional row limit. Use pageSize=all for a complete export.
        - schema:
            type: string
          in: query
          name: search
          required: false
          description: >-
            Case-insensitive text matched against the subject, sender and
            recipient name or email, and prospect domain. Applied before paging.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  truncated:
                    type: boolean
                  messages:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        conversationId:
                          type: string
                          nullable: true
                        direction:
                          type: string
                        subject:
                          type: string
                        body:
                          type: string
                        fromEmail:
                          type: string
                          nullable: true
                        fromName:
                          type: string
                          nullable: true
                        toEmail:
                          type: string
                          nullable: true
                        toName:
                          type: string
                          nullable: true
                        domain:
                          type: string
                          nullable: true
                        conversationStatus:
                          type: string
                          nullable: true
                        sentAt:
                          type: string
                          nullable: true
                      additionalProperties: true
                additionalProperties: true
        4XX:
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
                  code:
                    type: string
                  message:
                    type: string
                  reference:
                    type: string
        5XX:
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
                  code:
                    type: string
                  message:
                    type: string
                  reference:
                    type: string
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.