---
title: "Get Sequence Metrics"
method: GET
path: "/v1/sequence-templates/metrics"
tags: ["sequence-templates"]
---

# Get Sequence Metrics

`GET /v1/sequence-templates/metrics`

Report outreach performance over a date window.

Counters cover the window, not the lifetime of a template, and are counts
rather than rates: leads found, sent, opened, clicked, replied, positive
replies and hot leads, plus how the replies were categorised. Templates are
returned busiest first. Omit `sequence_template_id` to cover the whole
portfolio.

Requires the `sequences:read` scope on the API key.

## Query parameters

- `sequence_template_id` string, uuid, nullable — Report on one template. Omit to cover every template in the workspace.
- `days` integer — Lookback window in days, used when start_date and end_date are omitted.
- `start_date` string, date, nullable — Inclusive start of the reporting window.
- `end_date` string, date, nullable — Inclusive end of the window. Defaults to today.
- `channel` 'EMAIL' | 'LINKEDIN' | 'ALL' | 'MANUAL'
- `include_inactive` boolean — Include templates that are no longer active.

## Response `200`

Successful Response

- SequenceMetricsPublicOutput
  - `start_date` string, date, required — Inclusive first day of the reporting window.
  - `end_date` string, date, required — Inclusive last day of the reporting window.
  - `channel` 'EMAIL' | 'LINKEDIN' | 'ALL' | 'MANUAL', required
  - `sequences` SequenceTemplateMetricsPublicOutput[], required — Per-template counters, busiest first.
    - `sequence_template_id` string, uuid, required — Template these counters belong to.
    - `name` string, nullable, required — Name of the template.
    - `status` 'PENDING_SETUP' | 'ACTIVE' | 'INACTIVE' | 'FINISHING' | 'ARCHIVED', required
    - `metrics` SequenceMetricsCountersPublicOutput, required
      - `unique_found` integer, required — Leads found in the window.
      - `unique_sent` integer, required — Leads sent at least one message.
      - `total_sent` integer, required — Messages sent.
      - `unique_opens` integer, required — Leads who opened at least once.
      - `total_opens` integer, required — Opens recorded.
      - `unique_clicks` integer, required — Leads who clicked at least once.
      - `total_clicks` integer, required — Clicks recorded.
      - `unique_replies` integer, required — Leads who replied at least once.
      - `total_replies` integer, required — Replies received.
      - `unique_positive_replies` integer, required — Leads who replied positively at least once.
      - `total_positive_replies` integer, required — Positive replies received.
      - `unique_hot_leads` integer, required — Leads that turned hot.
      - `total_hot_leads` integer, required — Hot-lead events recorded.
  - `reply_categories` ReplyCategoryMetricsPublicOutput[], required — Reply breakdown across the templates reported on.
    - `reply_category` 'MEETING' | 'INTERESTED' | 'BAD_TIMING' | 'REFERRAL' | 'WRONG_PERSON' | 'LEFT_COMPANY' | 'OUT_OF_OFFICE' | 'SPAM_FILTER' | 'UNKNOWN' | 'UNSUBSCRIBED' | 'BOUNCED', required
    - `unique_replies` integer, required — Leads whose reply fell in this category.
    - `total_replies` integer, required — Replies in this category.

---

[API](https://skmtc.net/topo/apis/topo-public-api.md) · [All operations](https://skmtc.net/topo/apis/topo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topo/topo-public-api/revisions/ad6ac1d13526/schema)