---
title: "List Threads"
method: GET
path: "/api/channels/{channel}/accounts/{account_id}/threads"
tags: ["channels", "channels", "channel-threads"]
---

# List Threads

`GET /api/channels/{channel}/accounts/{account_id}/threads`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/channels/{channel}/accounts/{account_id}/threads`
- Auth: none declared

List threads for an account.

Args:
    channel: Channel name
    account_id: Account to list threads for
    limit: Maximum threads to return
    offset: Pagination offset
    is_archived: Filter by archived status
    is_pinned: Filter by pinned status
    search: Search query for thread title/last message

Returns:
    List of threads with pagination info

## Path parameters

- `channel` string, required
- `account_id` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `is_archived` boolean, nullable
- `is_pinned` boolean, nullable
- `is_included` boolean, nullable: Filter by inclusion status (excluded chats)
- `inclusion_reason` string, nullable: Exact inclusion_reason, e.g. scope_pending (chat picker)
- `kind` string, nullable: dm | group | channel
- `search` string, nullable: Search in thread title and last message
- `needs_follow_up` boolean, nullable: Filter by follow-up status
- `state` string, nullable: Filter by contact state: new, follow_up, active, warm, cooling, dormant, low
- `is_dormant` boolean, nullable: Filter by dormant status (legacy, prefer state=dormant)

## Response `200`

Successful Response

- ThreadListResponse: Thread list response.
  - `threads` object[], required
  - `total_count` integer, required
  - `has_more` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/d84e7dc9977d?raw)