List Sent Emails - Sequenzy

GET

api

email-sends

List Sent Emails

curl --request GET \
  --url https://api.sequenzy.com/api/v1/email-sends \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.sequenzy.com/api/v1/email-sends', 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/email-sends",
  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/email-sends"

	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/email-sends")

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

Returns the same 14-day delivery history used by the dashboard, including pending, successful, and failed test sends. Test rows have isTestEmail: true. Filter this field in your application if you want live deliveries only; isTestEmail is not a query parameter. CC/BCC bookkeeping rows remain hidden, except bounced or complained copied recipients that carry sender-health feedback. search (or q) searches both subject/title and recipient email. Use subject (title is an alias) or recipient when you need one field. The opened status includes clicked deliveries, matching the dashboard. Every row carries subscriberId, automationNodeId, and abTestVariantId alongside the delivery timestamps, so you can join rows into a recipient-level delivery matrix without falling back to the raw event stream. Filter by automationId, then group the returned rows by subscriberId in your application to see which contacts received which step of a sequence. subscriberId is not a query parameter. Use the recipient query for an email address or automationNodeId to list the recipients of one step directly. This history only reaches back 14 days. For per-step send totals over the full retained event window, read the steps array of Get Sequence Metrics or call List Per-Email Metrics.

Query Parameters

string

Case-insensitive subject or recipient search.

string

Case-insensitive subject/title filter. title is accepted as an alias.

string

Case-insensitive recipient email filter.

string

One of pending, sent, delivered, opened, clicked, bounced, complained, failed, or suppressed.

string

One of campaign, transactional, or sequence.

string

Permanent or Transient. This also restricts status to bounced.

string

Filter by campaign ID.

string

Filter by saved transactional email ID.

string

Filter by sequence/automation ID.

string

Filter by one email step of a sequence. Take the node ID from the steps array of the sequence metrics endpoint. Combined with automationId the two intersect, so a node from another sequence returns no rows.

string

Recipient mailbox provider, such as gmail, microsoft, yahoo, icloud, or orange. It uses the same values and recipient-domain classification as the analytics mailboxProvider filter, so a provider you see in analytics lists the same recipients here. other matches every domain outside the named providers. Case-insensitive; an unknown value returns 400.

string

Only sends to subscribers who are currently on this list and active, the same audience the analytics list filter uses. Subscribers who left the list, bounced, or unsubscribed are excluded. A list ID from another company returns no rows.

number

default:"14"

History window from 1 to 14 days.

number

default:"1"

Page number, starting at 1.

number

default:"20"

Results per page, from 1 to 100.

string

default:"createdAt"

recipientEmail, subject, status, eventAt, sentAt, or createdAt.

string

default:"desc"

asc or desc.

Example

curl "https://api.sequenzy.com/api/v1/email-sends?search=welcome&status=opened&emailType=transactional&days=7" \
  -H "Authorization: Bearer API_KEY"

200

{
  "success": true,
  "retentionDays": 14,
  "emailSends": [
    {
      "id": "send_123",
      "type": "transactional",
      "recipientEmail": "user@example.com",
      "subscriberId": "sub_abc123",
      "subject": "Welcome",
      "status": "clicked",
      "automationNodeId": null,
      "abTestVariantId": null,
      "eventAt": "2026-07-22T10:05:00.000Z",
      "openedAt": "2026-07-22T10:03:00.000Z",
      "clickedAt": "2026-07-22T10:05:00.000Z",
      "opened": true,
      "clicked": true
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  }
}

Pass a returned ID to GET /api/v1/email-sends/{emailSendId} for the stored snapshot and complete event timeline. A single delivery is opened or not opened: it does not have an open rate. Use transactional email metrics for aggregate rates.

List Sent Emails

curl --request GET \
  --url https://api.sequenzy.com/api/v1/email-sends \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.sequenzy.com/api/v1/email-sends', 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/email-sends",
  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/email-sends"

	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/email-sends")

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

​Query Parameters

​Example

Query Parameters

Example