> ## 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 mailboxes (filtered, paged)

> All mailboxes in the workspace with today's send count, filters and facets. Facets are computed before filters.

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



## OpenAPI

````yaml /openapi.json get /mailboxes/list
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:
  /mailboxes/list:
    get:
      tags:
        - Mailboxes
      summary: List mailboxes (filtered, paged)
      description: >-
        All mailboxes in the workspace with today's send count, filters and
        facets. Facets are computed before filters.


        **Minimum role:** `view` (`x-min-role`). **Destructive:** `false`
        (`x-destructive`).
      operationId: spa_mailboxes
      parameters:
        - description: Substring on email or sender name.
          in: query
          name: q
          required: false
          schema:
            type: string
        - description: active or needs_reconnect.
          in: query
          name: status
          required: false
          schema:
            type: string
        - description: on or off (sending enabled).
          in: query
          name: sending
          required: false
          schema:
            type: string
        - description: Exact tag.
          in: query
          name: tag
          required: false
          schema:
            type: string
        - description: Exact domain (lowercased).
          in: query
          name: domain
          required: false
          schema:
            type: string
        - description: >-
            email (default), status, sent_today, daily_limit, last_sent_at,
            dns_score, created_at.
          in: query
          name: sort
          required: false
          schema:
            type: string
        - description: '''desc'' for descending. Anything else ascending.'
          in: query
          name: dir
          required: false
          schema:
            type: string
        - description: Page size, 10-1000. Default 100.
          in: query
          name: size
          required: false
          schema:
            type: integer
        - description: Page number from 1.
          in: query
          name: page
          required: false
          schema:
            type: integer
      responses:
        '200':
          description: >-
            JSON {rows:[{id, email, domain, name, kind, status, enabled,
            daily_limit, sent_today, last_sent_at, last_error, tags, dns_score,
            warmup_health, created_at, campaigns}], total, page, pages, size,
            facets:{total, active, needs_reconnect, sending_on, sending_off,
            sent_today, capacity_today, tags, domains}}.
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.