List Sequence Events

GET

api

metrics

sequences

{sequenceId}

events

List Sequence Events

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

import requests

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

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}/events', 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}/events",
  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}/events"

	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}/events")

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",
  "automationNodeIds": ["node_email_1", "node_email_2"],
  "eventTypes": ["delivery"],
  "events": [
    {
      "id": "evt_abc123",
      "emailSendId": "send_abc123",
      "companyId": "company_123",
      "campaignId": "node_email_1",
      "transactionalEmailId": null,
      "subscriberId": "sub_123",
      "email": "user@example.com",
      "emailName": "Welcome",
      "emailType": "sequence",
      "abTestId": null,
      "abTestVariantId": null,
      "eventType": "delivery",
      "bounceType": null,
      "bounceSubType": null,
      "complaintType": null,
      "clickedUrl": null,
      "ipAddress": null,
      "userAgent": null,
      "countryCode": "US",
      "metadata": {},
      "eventTime": "2026-02-14T10:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total": 1,
    "totalPages": 1
  }
}

{
  "success": false,
  "error": "Invalid event type 'purchase'. Must be one of: send, delivery, bounce, complaint, open, click, unsubscribe, delivery_delay, transport_failure"
}

{
  "success": false,
  "error": "automationNodeId 'node_other' is not an email step of sequence 'seq_abc123'"
}

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

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

Returns a paginated raw event stream for every email step in a sequence, or for a single step via automationNodeId. The endpoint defaults to delivery events and resolves the sequence to its email and A/B test nodes before querying event storage. Use eventTypes to include opens, clicks, bounces, complaints, unsubscribes, sends, and delivery delays. This is the per-recipient event stream. For per-step totals, read the steps array of Get Sequence Metrics or call List Per-Email Metrics instead of counting these pages.

Path Parameters

string

required

The ID of the sequence.

Query Parameters

string

Scope the stream to one email step of this sequence. Take the node ID from the steps array of the sequence metrics endpoint. A node that is not an email step of this sequence returns 400, so a mistyped ID never reads as “this step sent nothing”. Defaults to every email step, and automationNodeIds in the response echoes what was queried.

string

default:"delivery"

Comma-separated event types. Supported values: send, delivery, bounce, complaint, open, click, unsubscribe, delivery_delay, transport_failure.

string

Single event type convenience alias. If both eventType and eventTypes are provided, both are included.

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.

number

default:"1"

Page number for pagination.

number

default:"100"

Events per page (max 500).

boolean

default:"false"

Set to true to include detected scanner, preview, and tracked asset open/click events when requesting engagement event types.

Common Queries

List delivered recipients for a sequence

curl "https://api.sequenzy.com/api/v1/metrics/sequences/seq_abc123/events?limit=100" \
 -H "Authorization: Bearer YOUR_API_KEY"

Include opens and clicks for sequence email steps

curl "https://api.sequenzy.com/api/v1/metrics/sequences/seq_abc123/events?eventTypes=delivery,open,click&period=30d" \
 -H "Authorization: Bearer YOUR_API_KEY"

List who received one specific step

curl "https://api.sequenzy.com/api/v1/metrics/sequences/seq_abc123/events?automationNodeId=node_email_4&limit=500" \
 -H "Authorization: Bearer YOUR_API_KEY"

Responses

{
  "success": true,
  "sequenceId": "seq_abc123",
  "automationNodeIds": ["node_email_1", "node_email_2"],
  "eventTypes": ["delivery"],
  "events": [
    {
      "id": "evt_abc123",
      "emailSendId": "send_abc123",
      "companyId": "company_123",
      "campaignId": "node_email_1",
      "transactionalEmailId": null,
      "subscriberId": "sub_123",
      "email": "user@example.com",
      "emailName": "Welcome",
      "emailType": "sequence",
      "abTestId": null,
      "abTestVariantId": null,
      "eventType": "delivery",
      "bounceType": null,
      "bounceSubType": null,
      "complaintType": null,
      "clickedUrl": null,
      "ipAddress": null,
      "userAgent": null,
      "countryCode": "US",
      "metadata": {},
      "eventTime": "2026-02-14T10:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total": 1,
    "totalPages": 1
  }
}

{
  "success": false,
  "error": "Invalid event type 'purchase'. Must be one of: send, delivery, bounce, complaint, open, click, unsubscribe, delivery_delay, transport_failure"
}

{
  "success": false,
  "error": "automationNodeId 'node_other' is not an email step of sequence 'seq_abc123'"
}

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

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

List Sequence Events

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

import requests

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

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}/events', 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}/events",
  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}/events"

	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}/events")

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",
  "automationNodeIds": ["node_email_1", "node_email_2"],
  "eventTypes": ["delivery"],
  "events": [
    {
      "id": "evt_abc123",
      "emailSendId": "send_abc123",
      "companyId": "company_123",
      "campaignId": "node_email_1",
      "transactionalEmailId": null,
      "subscriberId": "sub_123",
      "email": "user@example.com",
      "emailName": "Welcome",
      "emailType": "sequence",
      "abTestId": null,
      "abTestVariantId": null,
      "eventType": "delivery",
      "bounceType": null,
      "bounceSubType": null,
      "complaintType": null,
      "clickedUrl": null,
      "ipAddress": null,
      "userAgent": null,
      "countryCode": "US",
      "metadata": {},
      "eventTime": "2026-02-14T10:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total": 1,
    "totalPages": 1
  }
}

{
  "success": false,
  "error": "Invalid event type 'purchase'. Must be one of: send, delivery, bounce, complaint, open, click, unsubscribe, delivery_delay, transport_failure"
}

{
  "success": false,
  "error": "automationNodeId 'node_other' is not an email step of sequence 'seq_abc123'"
}

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

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

​Path Parameters

​Query Parameters

​Common Queries

​List delivered recipients for a sequence

​Include opens and clicks for sequence email steps

​List who received one specific step

​Responses

Path Parameters

Query Parameters

Common Queries

List delivered recipients for a sequence

Include opens and clicks for sequence email steps

List who received one specific step

Responses