List Campaign Events

GET

api

metrics

campaigns

{campaignId}

events

List Campaign Events

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

import requests

url = "https://api.sequenzy.com/api/v1/metrics/campaigns/{campaignId}/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/campaigns/{campaignId}/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/campaigns/{campaignId}/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/campaigns/{campaignId}/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/campaigns/{campaignId}/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,
  "campaignId": "camp_abc123",
  "eventTypes": ["delivery"],
  "events": [
    {
      "id": "evt_abc123",
      "emailSendId": "send_abc123",
      "companyId": "company_123",
      "campaignId": "camp_abc123",
      "transactionalEmailId": null,
      "subscriberId": "sub_123",
      "email": "user@example.com",
      "emailName": "February Newsletter",
      "emailType": "campaign",
      "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": "Unauthorized" }

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

Returns a paginated raw event stream for a campaign. The endpoint defaults to delivery events so you can audit delivered recipients, and can be expanded with eventTypes for opens, clicks, bounces, complaints, unsubscribes, sends, and delivery delays.

Path Parameters

string

required

The ID of the campaign.

Query Parameters

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 campaign

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

Include clicks with deliveries

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

Responses

{
  "success": true,
  "campaignId": "camp_abc123",
  "eventTypes": ["delivery"],
  "events": [
    {
      "id": "evt_abc123",
      "emailSendId": "send_abc123",
      "companyId": "company_123",
      "campaignId": "camp_abc123",
      "transactionalEmailId": null,
      "subscriberId": "sub_123",
      "email": "user@example.com",
      "emailName": "February Newsletter",
      "emailType": "campaign",
      "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": "Unauthorized" }

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

List Campaign Events

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

import requests

url = "https://api.sequenzy.com/api/v1/metrics/campaigns/{campaignId}/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/campaigns/{campaignId}/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/campaigns/{campaignId}/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/campaigns/{campaignId}/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/campaigns/{campaignId}/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,
  "campaignId": "camp_abc123",
  "eventTypes": ["delivery"],
  "events": [
    {
      "id": "evt_abc123",
      "emailSendId": "send_abc123",
      "companyId": "company_123",
      "campaignId": "camp_abc123",
      "transactionalEmailId": null,
      "subscriberId": "sub_123",
      "email": "user@example.com",
      "emailName": "February Newsletter",
      "emailType": "campaign",
      "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": "Unauthorized" }

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

​Path Parameters

​Query Parameters

​Common Queries

​List delivered recipients for a campaign

​Include clicks with deliveries

​Responses

Path Parameters

Query Parameters

Common Queries

List delivered recipients for a campaign

Include clicks with deliveries

Responses