---
title: "Get sequence stats"
method: GET
path: "/sequences/{sequenceId}/stats"
tags: ["Sequences"]
---

# Get sequence stats

`GET /sequences/{sequenceId}/stats`

Returns aggregated engagement metrics for a specific sequence. This is an alias for /metrics/sequences/{sequenceId}.

## Path parameters

- `sequenceId` string, required

## Query parameters

- `period` '1h' | '24h' | '7d' | '30d' | '90d'
- `start` string, date-time
- `end` string, date-time
- `includeMachineEngagement` boolean

## Response `200`

Success

- object
  - `success` boolean
  - `sequenceId` string
  - `period` string — Echoed back when `period` is provided.
  - `stats` EngagementStats — Unified engagement metrics returned by analytics endpoints. Open and click metrics exclude detected scanner, preview, and tracked asset events unless includeMachineEngagement is true.
    - `sent` integer
    - `delivered` integer — Capped at sent count
    - `bounced` integer — Unique bounces (deduplicated by email send)
    - `opened` integer — Unique opens (deduplicated by email send)
    - `clicked` integer — Unique clicks (deduplicated by email send)
    - `replies` integer — Inbound replies captured for delivered emails
    - `unsubscribed` integer
    - `deliveryRate` number — Percentage (0-100)
    - `bounceRate` number — Percentage (0-100), calculated from sent emails
    - `openRate` number — Percentage (0-100)
    - `clickRate` number — Percentage (0-100)
    - `replyRate` number — Percentage (0-100), calculated from delivered emails with sent as the fallback denominator
    - `unsubscribeRate` number — Percentage (0-100)
    - `conversions` integer — Attributed goal conversions (last-touch, 24h window). Only returned by campaign and sequence metrics endpoints.
    - `revenueCents` integer — Attributed revenue in cents from purchase events (saas.purchase and ecommerce.order_placed). Only returned by campaign and sequence metrics endpoints.
  - `steps` object[] — Per-email-step metrics, ordered by position in the sequence.
    - `step` integer — Step number.
    - `nodeId` string — Node ID for this email step.
    - `subject` string, nullable — Email subject line.
    - `stats` EngagementStats — Unified engagement metrics returned by analytics endpoints. Open and click metrics exclude detected scanner, preview, and tracked asset events unless includeMachineEngagement is true.
      - `sent` integer
      - `delivered` integer — Capped at sent count
      - `bounced` integer — Unique bounces (deduplicated by email send)
      - `opened` integer — Unique opens (deduplicated by email send)
      - `clicked` integer — Unique clicks (deduplicated by email send)
      - `replies` integer — Inbound replies captured for delivered emails
      - `unsubscribed` integer
      - `deliveryRate` number — Percentage (0-100)
      - `bounceRate` number — Percentage (0-100), calculated from sent emails
      - `openRate` number — Percentage (0-100)
      - `clickRate` number — Percentage (0-100)
      - `replyRate` number — Percentage (0-100), calculated from delivered emails with sent as the fallback denominator
      - `unsubscribeRate` number — Percentage (0-100)
      - `conversions` integer — Attributed goal conversions (last-touch, 24h window). Only returned by campaign and sequence metrics endpoints.
      - `revenueCents` integer — Attributed revenue in cents from purchase events (saas.purchase and ecommerce.order_placed). Only returned by campaign and sequence metrics endpoints.
    - `failedCount` integer — Number of subscribers that failed at this step.
    - `failedSubscribers` object[] — Up to 20 most recent failed subscribers for this step.
      - `subscriberId` string
      - `email` string, nullable
      - `failedAt` string, date-time
      - `failedReason` string, nullable

## Other responses

- `401` — Unauthorized
- `403` — No company selected
- `404` — Sequence not found

## Changes

- **2026-07-16** `ad2202945c5b` — 4 info
  - added the optional property `stats/replies` to the response with the `200` status
  - added the optional property `stats/replyRate` to the response with the `200` status
  - added the optional property `steps/items/stats/replies` to the response with the `200` status
  - added the optional property `steps/items/stats/replyRate` to the response with the `200` status
- **2026-06-19** `fd494fa7e64d` — 1 info
  - added the new optional `query` request parameter `includeMachineEngagement`
- **2026-06-12** `f9a826460811` — 4 info
  - added the optional property `stats/conversions` to the response with the `200` status
  - added the optional property `stats/revenueCents` to the response with the `200` status
  - added the optional property `steps/items/stats/conversions` to the response with the `200` status
  - added the optional property `steps/items/stats/revenueCents` to the response with the `200` status
- **2026-05-15** `b040bb8c6608` — 4 info
  - added the optional property `stats/bounceRate` to the response with the `200` status
  - added the optional property `stats/bounced` to the response with the `200` status
  - added the optional property `steps/items/stats/bounceRate` to the response with the `200` status
  - added the optional property `steps/items/stats/bounced` to the response with the `200` status
- **2026-04-20** `ed7439559402` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/sequences/:sequenceId/stats/get.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/09f0c32988fb/schema)