Skip to main content
GET
/
api
/
v1
/
metrics
/
sequences
/
{sequenceId}
Get Sequence Metrics
curl --request GET \
  --url https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "sequenceId": "seq_abc123",
  "stats": {
    "sent": 122,
    "delivered": 120,
    "opened": 80,
    "clicked": 5,
    "unsubscribed": 1,
    "deliveryRate": 98.36,
    "openRate": 66.67,
    "clickRate": 4.17,
    "unsubscribeRate": 0.83
  },
  "steps": [
    {
      "step": 1,
      "nodeId": "node_001",
      "subject": "Welcome to our platform",
      "stats": { "sent": 60, "delivered": 59, "opened": 40, "clicked": 3, "unsubscribed": 0, "deliveryRate": 98.33, "openRate": 67.8, "clickRate": 5.08, "unsubscribeRate": 0 },
      "failedCount": 0,
      "failedSubscribers": []
    },
    {
      "step": 2,
      "nodeId": "node_002",
      "subject": "Quick tips to get started",
      "stats": { "sent": 44, "delivered": 43, "opened": 30, "clicked": 2, "unsubscribed": 1, "deliveryRate": 97.73, "openRate": 69.77, "clickRate": 4.65, "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, "opened": 10, "clicked": 0, "unsubscribed": 0, "deliveryRate": 100, "openRate": 55.56, "clickRate": 0, "unsubscribeRate": 0 },
      "failedCount": 0,
      "failedSubscribers": []
    }
  ]
}
Returns aggregate engagement metrics for a sequence (automation) plus a per-step breakdown showing how each email in the sequence performed. Each step also includes recent failed subscribers and their failure reasons. Both aggregate and per-step metrics respect the time filter.

​
Path Parameters

​
sequenceId
string
required
The ID of the sequence.

​
Query Parameters

​
period
string
Sliding time window. One of: 1h, 24h, 7d, 30d, 90d. Ignored when start and end are provided.
​
start
string
Start of custom time range (ISO 8601). Must be used with end.
​
end
string
End of custom time range (ISO 8601). Must be used with start. Max range: 90 days.

​
Response Fields

FieldTypeDescription
sequenceIdstringThe sequence ID
statsobjectAggregate stats across all steps (same shape as below)
stepsarrayPer-step metrics, ordered by position
Stats object (used for both aggregate and per-step):
FieldTypeDescription
sentnumberEmails sent
deliverednumberEmails delivered
openednumberUnique opens
clickednumberUnique clicks
unsubscribednumberUnsubscribes
deliveryRatenumberDelivery rate percentage
openRatenumberOpen rate percentage
clickRatenumberClick rate percentage
unsubscribeRatenumberUnsubscribe rate percentage
Steps array:
FieldTypeDescription
stepnumberStep number (1-indexed)
nodeIdstringNode ID for this email step
subjectstring|nullEmail subject line
statsobjectStats for this step
failedCountnumberNumber of subscribers that failed at this step
failedSubscribersarrayUp to 20 most recent failed subscribers for this step
Failed subscriber object:
FieldTypeDescription
subscriberIdstringSubscriber ID
emailstring|nullSubscriber email captured on the token
failedAtstringWhen the token failed (ISO 8601)
failedReasonstring|nullStored 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.

​
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.

​
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,
    "opened": 80,
    "clicked": 5,
    "unsubscribed": 1,
    "deliveryRate": 98.36,
    "openRate": 66.67,
    "clickRate": 4.17,
    "unsubscribeRate": 0.83
  },
  "steps": [
    {
      "step": 1,
      "nodeId": "node_001",
      "subject": "Welcome to our platform",
      "stats": { "sent": 60, "delivered": 59, "opened": 40, "clicked": 3, "unsubscribed": 0, "deliveryRate": 98.33, "openRate": 67.8, "clickRate": 5.08, "unsubscribeRate": 0 },
      "failedCount": 0,
      "failedSubscribers": []
    },
    {
      "step": 2,
      "nodeId": "node_002",
      "subject": "Quick tips to get started",
      "stats": { "sent": 44, "delivered": 43, "opened": 30, "clicked": 2, "unsubscribed": 1, "deliveryRate": 97.73, "openRate": 69.77, "clickRate": 4.65, "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, "opened": 10, "clicked": 0, "unsubscribed": 0, "deliveryRate": 100, "openRate": 55.56, "clickRate": 0, "unsubscribeRate": 0 },
      "failedCount": 0,
      "failedSubscribers": []
    }
  ]
}