Get Sequence Metrics

GET

api

metrics

sequences

{sequenceId}

Get Sequence Metrics

curl --request GET \
  --url https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "sequenceId": "seq_abc123",
  "stats": {
    "sent": 122,
    "delivered": 120,
    "bounced": 2,
    "opened": 80,
    "clicked": 5,
    "replies": 9,
    "unsubscribed": 1,
    "deliveryRate": 98.36,
    "bounceRate": 1.64,
    "openRate": 66.67,
    "clickRate": 4.17,
    "replyRate": 7.5,
    "unsubscribeRate": 0.83,
    "conversions": 4,
    "revenueCents": 27800
  },
  "enrollmentCounts": {
    "active": 4,
    "waiting": 26,
    "total": 30,
    "byCurrentNode": [
      {
        "currentNodeId": "node_wait_3_days",
        "currentNodeType": "logic_delay",
        "currentNodeLabel": "Wait three days",
        "currentNodeMissing": false,
        "active": 0,
        "waiting": 18,
        "total": 18
      },
      {
        "currentNodeId": "node_002",
        "currentNodeType": "action_email",
        "currentNodeLabel": "Quick tips to get started",
        "currentNodeMissing": false,
        "active": 4,
        "waiting": 8,
        "total": 12
      }
    ]
  },
  "steps": [
    {
      "step": 1,
      "nodeId": "node_001",
      "subject": "Welcome to our platform",
      "stats": { "sent": 60, "delivered": 59, "bounced": 1, "opened": 40, "clicked": 3, "replies": 6, "unsubscribed": 0, "deliveryRate": 98.33, "bounceRate": 1.67, "openRate": 67.8, "clickRate": 5.08, "replyRate": 10.17, "unsubscribeRate": 0 },
      "failedCount": 0,
      "failedSubscribers": []
    },
    {
      "step": 2,
      "nodeId": "node_002",
      "subject": "Quick tips to get started",
      "stats": { "sent": 44, "delivered": 43, "bounced": 1, "opened": 30, "clicked": 2, "replies": 3, "unsubscribed": 1, "deliveryRate": 97.73, "bounceRate": 2.27, "openRate": 69.77, "clickRate": 4.65, "replyRate": 6.98, "unsubscribeRate": 2.33 },
      "failedCount": 2,
      "failedSubscribers": [
        {
          "subscriberId": "sub_failed_001",
          "email": "failed@example.com",
          "failedAt": "2026-02-14T09:32:11.000Z",
          "failedReason": "Email template ID is required"
        },
        {
          "subscriberId": "sub_failed_002",
          "email": "unknown@example.com",
          "failedAt": "2026-02-14T09:11:42.000Z",
          "failedReason": "Node node_002 not found"
        }
      ]
    },
    {
      "step": 3,
      "nodeId": "node_003",
      "subject": "Your first week recap",
      "stats": { "sent": 18, "delivered": 18, "bounced": 0, "opened": 10, "clicked": 0, "replies": 0, "unsubscribed": 0, "deliveryRate": 100, "bounceRate": 0, "openRate": 55.56, "clickRate": 0, "replyRate": 0, "unsubscribeRate": 0 },
      "failedCount": 0,
      "failedSubscribers": []
    }
  ]
}

{
  "success": false,
  "error": "Invalid period. Must be one of: 1h, 24h, 7d, 30d, 90d"
}

{ "success": false, "error": "Unauthorized" }

{ "success": false, "error": "Sequence not found" }

{ "success": false, "error": "Internal server error" }

Returns aggregate engagement metrics for a sequence (automation), a live active/waiting enrollment breakdown by current node, and a per-step breakdown showing how each email performed, including replies and reply rates. Each step also includes recent failed subscribers and their failure reasons. Aggregate and per-step performance metrics respect the time filter; enrollmentCounts is always a point-in-time snapshot. Test sends are excluded from performance metrics and attributed revenue by default so previews do not skew results, but they still count toward send usage and quota. Open and click metrics also exclude detected email-security scanners and tracked brand assets by default.

Path Parameters

string

required

The ID of the sequence.

Query Parameters

string

Sliding time window. One of: 1h, 24h, 7d, 30d, 90d. Ignored when start and end are provided.

string

Start of custom time range (ISO 8601). Must be used with end.

string

End of custom time range (ISO 8601). Must be used with start. Max range: 90 days.

boolean

default:"false"

Set to true to include detected scanner, preview, and tracked asset open/click events in engagement metrics.

How a period is applied

When you filter with period or start/end, the response is a funnel over the sends made inside that window, not a log of events that happened inside it. sent counts those sends, and every delivery, engagement, and reply count is attributed to one of them - including a reply or an open that arrives after the window closes. Activity on sends that predate the window is excluded, so opened <= delivered <= sent always holds and no rate can exceed 100%. conversions and revenueCents are the exception: they use the goal’s own last-touch attribution window rather than the send cohort. opened and clicked are unique counts deduplicated by email send: one recipient opening the same email five times counts once. Rates divide by rateDenominator (delivered, falling back to sent), which is returned alongside rateDenominatorBasis so you can reproduce the arithmetic.

Response Fields

Field	Type	Description
`sequenceId`	`string`	The sequence ID
`stats`	`object`	Aggregate stats across all steps (same shape as below)
`enrollmentCounts`	`object`	Live active/waiting enrollment counts by current node
`enrollmentSkipped`	`object`	Trigger matches where the contact could not be enrolled
`steps`	`array`	Per-step metrics, ordered by position

Stats object (used for both aggregate and per-step):

Field	Type	Description
`sent`	`number`	Emails sent
`delivered`	`number`	Emails delivered
`bounced`	`number`	Emails that bounced
`opened`	`number`	Unique opens
`clicked`	`number`	Unique clicks
`replies`	`number`	Inbound replies captured for the sequence or step
`unsubscribed`	`number`	Unsubscribes
`deliveryRate`	`number`	Delivery rate percentage
`bounceRate`	`number`	Bounce rate percentage
`openRate`	`number`	Open rate percentage
`clickRate`	`number`	Click rate percentage
`replyRate`	`number`	Reply rate percentage
`unsubscribeRate`	`number`	Unsubscribe rate percentage
`rateDenominator`	`number`	The number every engagement rate divides by
`rateDenominatorBasis`	`string`	Which field `rateDenominator` came from: `delivered`, `sent`, or `none`
`conversions`	`number`	Goal conversions attributed to this sequence (last-touch, 24h window)
`revenueCents`	`number`	Attributed revenue in cents from purchase events (`saas.purchase` and `ecommerce.order_placed`)

The conversions and revenueCents fields appear on the top-level stats object only, not on per-step stats. Enrollment counts object:

Field	Type	Description
`active`	`number`	Active enrollment-token count
`waiting`	`number`	Waiting enrollment-token count
`total`	`number`	Active plus waiting enrollment-token count
`byCurrentNode`	`array`	The same counts grouped by the token’s current node

Each byCurrentNode entry contains currentNodeId, optional currentNodeType and currentNodeLabel, currentNodeMissing, and the active, waiting, and total counts. Missing nodes remain in the response so the total always reconciles even after a live sequence graph is edited. These counts represent enrollment runs, not necessarily distinct subscribers. They are read live and do not use period, start, or end. Enrollment skipped object:

Field	Type	Description
`count`	`number`	Total trigger matches where the contact could not be enrolled
`byReason`	`object`	Skip counts keyed by reason (`unsubscribed`, `bounced`)

Unsubscribed and bounced contacts never enter sequences, so a trigger match for them is recorded as a skip instead of an enrollment. When the request has no explicit time range, enrollmentSkipped covers the last 30 days. Steps array:

Field	Type	Description
`step`	`number`	Step number (1-indexed)
`nodeId`	`string`	Node ID for this email step
`subject`	`string\|null`	Email subject line
`stats`	`object`	Stats for this step
`failedCount`	`number`	Number of subscribers that failed at this step
`failedSubscribers`	`array`	Up to 20 most recent failed subscribers for this step

Failed subscriber object:

Field	Type	Description
`subscriberId`	`string`	Subscriber ID
`email`	`string\|null`	Subscriber email captured on the token
`failedAt`	`string`	When the token failed (ISO 8601)
`failedReason`	`string\|null`	Stored failure reason for the token

Common Queries

How is our onboarding sequence performing overall?

curl "https://api.sequenzy.com/api/v1/metrics/sequences/seq_abc123" \
 -H "Authorization: Bearer YOUR_API_KEY"

Check the top-level stats for aggregate performance across all steps.

How many enrollments are waiting at each stage right now?

curl "https://api.sequenzy.com/api/v1/metrics/sequences/seq_abc123?period=7d" \
 -H "Authorization: Bearer YOUR_API_KEY"

Read enrollmentCounts.byCurrentNode. The 7-day filter scopes historical performance metrics only; the active/waiting counts still reflect the current sequence state.

Which step has the highest drop-off?

curl "https://api.sequenzy.com/api/v1/metrics/sequences/seq_abc123" \
 -H "Authorization: Bearer YOUR_API_KEY"

Compare openRate across the steps array. A sharp drop between consecutive steps signals where subscribers lose interest.

How many people unsubscribed from the second email?

curl "https://api.sequenzy.com/api/v1/metrics/sequences/seq_abc123" \
 -H "Authorization: Bearer YOUR_API_KEY"

Look at steps[1].stats.unsubscribed (step 2, zero-indexed in the array). If the unsubscribe rate is high on a specific step, consider revising that email’s content or timing.

How has the sequence performed this month?

curl "https://api.sequenzy.com/api/v1/metrics/sequences/seq_abc123?start=2026-02-01T00:00:00Z&end=2026-02-28T00:00:00Z" \
 -H "Authorization: Bearer YOUR_API_KEY"

Both aggregate and per-step metrics will be scoped to this time range.

How many step-4 emails went out across several sequences?

The steps array covers one sequence per request. To total or compare the same step across many sequences in a single call, use List Per-Email Metrics:

curl "https://api.sequenzy.com/api/v1/metrics/emails?sequenceId=seq_abc123,seq_def456&step=4" \
 -H "Authorization: Bearer YOUR_API_KEY"

Step numbers and per-step counts match this endpoint’s steps array, so the two surfaces never disagree about which email is step 4.

Who received one specific step?

Pass a steps[].nodeId to List Sequence Events as automationNodeId for the retained per-recipient event stream, or to List Sent Emails for the last 14 days of delivery rows.

Who engaged with this sequence?

Use the Get Recipients endpoint with a sequenceId filter:

curl "https://api.sequenzy.com/api/v1/metrics/recipients?sequenceId=seq_abc123" \
 -H "Authorization: Bearer YOUR_API_KEY"

Responses

{
  "success": true,
  "sequenceId": "seq_abc123",
  "stats": {
    "sent": 122,
    "delivered": 120,
    "bounced": 2,
    "opened": 80,
    "clicked": 5,
    "replies": 9,
    "unsubscribed": 1,
    "deliveryRate": 98.36,
    "bounceRate": 1.64,
    "openRate": 66.67,
    "clickRate": 4.17,
    "replyRate": 7.5,
    "unsubscribeRate": 0.83,
    "conversions": 4,
    "revenueCents": 27800
  },
  "enrollmentCounts": {
    "active": 4,
    "waiting": 26,
    "total": 30,
    "byCurrentNode": [
      {
        "currentNodeId": "node_wait_3_days",
        "currentNodeType": "logic_delay",
        "currentNodeLabel": "Wait three days",
        "currentNodeMissing": false,
        "active": 0,
        "waiting": 18,
        "total": 18
      },
      {
        "currentNodeId": "node_002",
        "currentNodeType": "action_email",
        "currentNodeLabel": "Quick tips to get started",
        "currentNodeMissing": false,
        "active": 4,
        "waiting": 8,
        "total": 12
      }
    ]
  },
  "steps": [
    {
      "step": 1,
      "nodeId": "node_001",
      "subject": "Welcome to our platform",
      "stats": { "sent": 60, "delivered": 59, "bounced": 1, "opened": 40, "clicked": 3, "replies": 6, "unsubscribed": 0, "deliveryRate": 98.33, "bounceRate": 1.67, "openRate": 67.8, "clickRate": 5.08, "replyRate": 10.17, "unsubscribeRate": 0 },
      "failedCount": 0,
      "failedSubscribers": []
    },
    {
      "step": 2,
      "nodeId": "node_002",
      "subject": "Quick tips to get started",
      "stats": { "sent": 44, "delivered": 43, "bounced": 1, "opened": 30, "clicked": 2, "replies": 3, "unsubscribed": 1, "deliveryRate": 97.73, "bounceRate": 2.27, "openRate": 69.77, "clickRate": 4.65, "replyRate": 6.98, "unsubscribeRate": 2.33 },
      "failedCount": 2,
      "failedSubscribers": [
        {
          "subscriberId": "sub_failed_001",
          "email": "failed@example.com",
          "failedAt": "2026-02-14T09:32:11.000Z",
          "failedReason": "Email template ID is required"
        },
        {
          "subscriberId": "sub_failed_002",
          "email": "unknown@example.com",
          "failedAt": "2026-02-14T09:11:42.000Z",
          "failedReason": "Node node_002 not found"
        }
      ]
    },
    {
      "step": 3,
      "nodeId": "node_003",
      "subject": "Your first week recap",
      "stats": { "sent": 18, "delivered": 18, "bounced": 0, "opened": 10, "clicked": 0, "replies": 0, "unsubscribed": 0, "deliveryRate": 100, "bounceRate": 0, "openRate": 55.56, "clickRate": 0, "replyRate": 0, "unsubscribeRate": 0 },
      "failedCount": 0,
      "failedSubscribers": []
    }
  ]
}

{
  "success": false,
  "error": "Invalid period. Must be one of: 1h, 24h, 7d, 30d, 90d"
}

{ "success": false, "error": "Unauthorized" }

{ "success": false, "error": "Sequence not found" }

{ "success": false, "error": "Internal server error" }

Get Sequence Metrics

curl --request GET \
  --url https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "sequenceId": "seq_abc123",
  "stats": {
    "sent": 122,
    "delivered": 120,
    "bounced": 2,
    "opened": 80,
    "clicked": 5,
    "replies": 9,
    "unsubscribed": 1,
    "deliveryRate": 98.36,
    "bounceRate": 1.64,
    "openRate": 66.67,
    "clickRate": 4.17,
    "replyRate": 7.5,
    "unsubscribeRate": 0.83,
    "conversions": 4,
    "revenueCents": 27800
  },
  "enrollmentCounts": {
    "active": 4,
    "waiting": 26,
    "total": 30,
    "byCurrentNode": [
      {
        "currentNodeId": "node_wait_3_days",
        "currentNodeType": "logic_delay",
        "currentNodeLabel": "Wait three days",
        "currentNodeMissing": false,
        "active": 0,
        "waiting": 18,
        "total": 18
      },
      {
        "currentNodeId": "node_002",
        "currentNodeType": "action_email",
        "currentNodeLabel": "Quick tips to get started",
        "currentNodeMissing": false,
        "active": 4,
        "waiting": 8,
        "total": 12
      }
    ]
  },
  "steps": [
    {
      "step": 1,
      "nodeId": "node_001",
      "subject": "Welcome to our platform",
      "stats": { "sent": 60, "delivered": 59, "bounced": 1, "opened": 40, "clicked": 3, "replies": 6, "unsubscribed": 0, "deliveryRate": 98.33, "bounceRate": 1.67, "openRate": 67.8, "clickRate": 5.08, "replyRate": 10.17, "unsubscribeRate": 0 },
      "failedCount": 0,
      "failedSubscribers": []
    },
    {
      "step": 2,
      "nodeId": "node_002",
      "subject": "Quick tips to get started",
      "stats": { "sent": 44, "delivered": 43, "bounced": 1, "opened": 30, "clicked": 2, "replies": 3, "unsubscribed": 1, "deliveryRate": 97.73, "bounceRate": 2.27, "openRate": 69.77, "clickRate": 4.65, "replyRate": 6.98, "unsubscribeRate": 2.33 },
      "failedCount": 2,
      "failedSubscribers": [
        {
          "subscriberId": "sub_failed_001",
          "email": "failed@example.com",
          "failedAt": "2026-02-14T09:32:11.000Z",
          "failedReason": "Email template ID is required"
        },
        {
          "subscriberId": "sub_failed_002",
          "email": "unknown@example.com",
          "failedAt": "2026-02-14T09:11:42.000Z",
          "failedReason": "Node node_002 not found"
        }
      ]
    },
    {
      "step": 3,
      "nodeId": "node_003",
      "subject": "Your first week recap",
      "stats": { "sent": 18, "delivered": 18, "bounced": 0, "opened": 10, "clicked": 0, "replies": 0, "unsubscribed": 0, "deliveryRate": 100, "bounceRate": 0, "openRate": 55.56, "clickRate": 0, "replyRate": 0, "unsubscribeRate": 0 },
      "failedCount": 0,
      "failedSubscribers": []
    }
  ]
}

{
  "success": false,
  "error": "Invalid period. Must be one of: 1h, 24h, 7d, 30d, 90d"
}

{ "success": false, "error": "Unauthorized" }

{ "success": false, "error": "Sequence not found" }

{ "success": false, "error": "Internal server error" }

​Path Parameters

​Query Parameters

​How a period is applied

​Response Fields

​Common Queries

​How is our onboarding sequence performing overall?

​How many enrollments are waiting at each stage right now?

​Which step has the highest drop-off?

​How many people unsubscribed from the second email?

​How has the sequence performed this month?

​How many step-4 emails went out across several sequences?

​Who received one specific step?

​Who engaged with this sequence?

​Responses

Path Parameters

Query Parameters

How a period is applied

Response Fields

Common Queries

How is our onboarding sequence performing overall?

How many enrollments are waiting at each stage right now?

Which step has the highest drop-off?

How many people unsubscribed from the second email?

How has the sequence performed this month?

How many step-4 emails went out across several sequences?

Who received one specific step?

Who engaged with this sequence?

Responses