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

# List inbox threads

> Conversation list, newest first, capped at 500 (truncated flag). Defaults show positive replies from campaigns with automated replies hidden. Boolean flags are true only when the value is exactly '1'. Counts are computed before the stage filter.

**Minimum role:** `view` (`x-min-role`). **Destructive:** `false` (`x-destructive`).



## OpenAPI

````yaml /openapi.json get /inbox/threads
openapi: 3.0.3
info:
  title: Sales Sequencer API
  version: '1'
  description: >-
    Every Sales Sequencer action over HTTP. Each call runs as the API key's
    creator, with that user's role, in the key's workspace. Auth: X-API-Key
    header.
servers:
  - url: https://api.salessequencer.com/api/v1
security:
  - key: []
paths:
  /inbox/threads:
    get:
      tags:
        - Inbox
      summary: List inbox threads
      description: >-
        Conversation list, newest first, capped at 500 (truncated flag).
        Defaults show positive replies from campaigns with automated replies
        hidden. Boolean flags are true only when the value is exactly '1'.
        Counts are computed before the stage filter.


        **Minimum role:** `view` (`x-min-role`). **Destructive:** `false`
        (`x-destructive`).
      operationId: spa_inbox
      parameters:
        - description: >-
            Stage key, 'positive' (default) or 'all'. Stages: interested,
            meeting_request, not_interested, objection, pricing_question,
            more_info_needed, timing_issue, wrong_person, out_of_office,
            automated, unsubscribe, unclassified.
          in: query
          name: stage
          required: false
          schema:
            type: string
        - description: >-
            '1' (default) = campaign replies only; any other value includes
            non-campaign threads.
          in: query
          name: campaign_only
          required: false
          schema:
            type: string
        - description: >-
            '1' (default) hides automated/out-of-office; any other value shows
            them.
          in: query
          name: exclude_auto
          required: false
          schema:
            type: string
        - description: '''1'' = unread only. Default off.'
          in: query
          name: unread
          required: false
          schema:
            type: string
        - description: '''1'' = threads with an open reminder. Default off.'
          in: query
          name: reminders
          required: false
          schema:
            type: string
        - description: Substring on sender, subject, snippet, contact email.
          in: query
          name: q
          required: false
          schema:
            type: string
        - description: Exact sending mailbox email.
          in: query
          name: mailbox
          required: false
          schema:
            type: string
        - description: Exact thread tag.
          in: query
          name: tag
          required: false
          schema:
            type: string
        - description: Campaign id.
          in: query
          name: campaign
          required: false
          schema:
            type: integer
      responses:
        '200':
          description: >-
            JSON {items:[{thread_id, prospect_email, name, company, title,
            subject, snippet, last_at, age_days, unread, messages, needs_reply,
            stage, campaign:{id,name}, mailbox, tags, has_reminder, is_auto}],
            truncated, filters, counts:{by_stage, positive, all, unread,
            unread_all, exact}, tags, mailboxes}.
components:
  securitySchemes:
    key:
      in: header
      name: X-API-Key
      type: apiKey

````

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