---
title: "Get Filter Counts"
method: GET
path: "/api/threads/filter-counts"
tags: ["threads", "threads"]
---

# Get Filter Counts

`GET /api/threads/filter-counts`

## 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/threads/filter-counts`
- Auth: none declared

Get counts for all thread filters (needs_reply, states, AI tags).

Returns counts for:
- needs_reply: DM threads where last message is inbound and user hasn't replied
- states: counts by contact state (new, follow_up, active, warm, cooling, dormant, low)
- ai_tags: counts per AI tag

Args:
    channels: Optional comma-separated list of channels to filter by (e.g., "telegram,instagram")

Results are cached in Redis for 30 seconds to improve performance.

## Query parameters

- `channels` string, nullable: Filter by channel types (comma-separated, e.g. telegram,instagram)

## Response `200`

Successful Response

- unknown

## 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/77bef09a9209?raw)