---
title: "Get Stats Extended Overview"
method: GET
path: "/v1/stats/extended_overview"
tags: ["stats"]
---

# Get Stats Extended Overview

`GET /v1/stats/extended_overview`

## Request

- Base URL: `https://api.linktodm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.linktodm.com/v1/stats/extended_overview`
- Auth: HTTP bearer

Return dms_sent + follows + contacts for the authenticated user.

Heavier counterpart to `/overview` — separated so the page can render
top-of-funnel numbers fast and let conversion-side numbers resolve later.
Same range + channel filtering semantics as `/overview`.

## Query parameters

- `range` 'all' | '24h' | '7d' | '30d': Time-range window applied to every metric on the stats page. Mirrors the frontend tabs (`All time / 24 hours / 7 days / 30 days`).
- `channel_id` string, nullable

## Response `200`

Successful Response

- StatsExtendedOverviewResponse: Conversion-side aggregate counts for the current user. Split from `StatsOverviewResponse` because these branches scan substantially more rows for high-volume users (notably the contacts and follows branches). - `dms_sent`: DMs successfully sent — `event_tracker.AUTODM_DM_SENT` for normal automations plus `flow_execution_step` rows whose `node_type` is one of the four message-sending node types (PLAIN_TEXT_MESSAGE, BUTTON_TEXT_MESSAGE, BUTTON_TEXT_IMAGE_MESSAGE, CAROUSEL_BUTTON_TEXT_IMAGE_MESSAGE) and whose `status` is COMPLETED. - `follows`: distinct users who received a follow request from a normal automation and were subsequently sent a DM — same logic as `event_tracker.get_new_followers_summary` but user-wide rather than per-automation. - `contacts`: count of `contact` rows for the user. For `range=all` this is the lifetime audience size; for any other range it's contacts first seen within the window (i.e. contacts gained). CTR is derived on the frontend as `clicks / dms_sent`, so CTR only renders once both this endpoint and `/v1/stats/overview` resolve.
  - `dms_sent` integer, required
  - `follows` integer, required
  - `contacts` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/linktodm/apis/salesmorph.md) - [All operations](https://skmtc.dev/linktodm/apis/salesmorph/llms.txt) - [OpenAPI document](https://skmtc.dev/linktodm/apis/salesmorph/revisions/4af0ad5dbe92?raw)