---
title: "Get Unified Counts"
method: GET
path: "/api/outreach/stats/counts"
tags: ["outreach", "outreach"]
---

# Get Unified Counts

`GET /api/outreach/stats/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/outreach/stats/counts`
- Auth: none declared

Unified counts for both DM and group outreach candidates.
Returns breakdown by state, segment, or channel with dm_count + group_count per key.
When group_by="all", returns all 3 dimensions in one call.

## Query parameters

- `group_by` 'state' | 'segment' | 'channel' | 'all', required
- `channels` string, nullable: Comma-separated: telegram,whatsapp,email
- `exclude_recent_days` integer, nullable: Exclude contacts contacted in last N days (1=today)

## Response `200`

Successful Response

- SrcApiOutreachCountsResponse: Counts response with DM + group breakdown.
  - `group_by` string, required
  - `counts` CountItem[], required
    - `key` string, required
    - `dm_count` integer
    - `group_count` integer
    - `total` integer
  - `state_counts` CountItem[], nullable
    - `key` string, required
    - `dm_count` integer
    - `group_count` integer
    - `total` integer
  - `segment_counts` CountItem[], nullable
    - `key` string, required
    - `dm_count` integer
    - `group_count` integer
    - `total` integer
  - `channel_counts` CountItem[], nullable
    - `key` string, required
    - `dm_count` integer
    - `group_count` integer
    - `total` integer
  - `tag_counts` object
  - `dm_total` integer, required
  - `group_total` integer, required
  - `total` integer, 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/77bef09a9209?raw)