---
title: "List Threads"
method: GET
path: "/mailbox/{mailbox_uid}/threads"
---

# List Threads

`GET /mailbox/{mailbox_uid}/threads`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/mailbox/{mailbox_uid}/threads`
- Auth: API key in header `x-api-key`

List email threads (conversations).

## Path parameters

- `mailbox_uid` string, required

## Query parameters

- `filter.folder_id` string
- `filter.unread` boolean
- `filter.starred` boolean
- `filter.any_email` string
- `filter.from` string
- `filter.to` string
- `filter.has_attachment` boolean
- `filter.subject` string
- `filter.latest_message_after` integer
- `filter.latest_message_before` integer
- `page` integer
- `limit` integer

## Response `200`

- object
  - `type` string
  - `data` object
    - `threads` object[]
      - `mailbox_uid` string
      - `thread_id` string
      - `latest_draft_or_message` object
        - `bcc` object[]
          - `name` string
          - `email` string
        - `body` string
        - `cc` object[]
          - `name` string
          - `email` string
        - `folders` string[]
        - `from` object[]
          - `name` string
          - `email` string
        - `headers` object[]
          - `name` string
          - `value` string
        - `thread_id` string
      - `has_attachments` boolean
      - `has_drafts` boolean
      - `earliest_message_date` integer
      - `latest_message_received_date` integer
      - `latest_message_sent_date` integer
      - `participants` object[]
        - `email` string
        - `name` string

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/mailbox/:mailbox_uid/threads/get.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)