---
title: "List sent emails"
method: GET
path: "/email-sends"
tags: ["Email Sends"]
---

# List sent emails

`GET /email-sends`

Lists the recent 14-day delivery history with dashboard-equivalent subject, recipient, status, type, bounce, source, pagination, and sorting filters. Test sends and copied-recipient bookkeeping rows are hidden unless the copy bounced or complained.

## Query parameters

- `search` string
- `q` string
- `subject` string
- `title` string
- `recipient` string
- `status` 'pending' | 'sent' | 'delivered' | 'opened' | 'clicked' | 'bounced' | 'complained' | 'failed' | 'suppressed'
- `emailType` 'campaign' | 'transactional' | 'sequence'
- `bounceType` 'Permanent' | 'Transient'
- `campaignId` string
- `transactionalEmailId` string
- `automationId` string
- `automationNodeId` string
- `days` integer
- `page` integer
- `limit` integer
- `sortField` 'recipientEmail' | 'subject' | 'status' | 'eventAt' | 'sentAt' | 'createdAt'
- `sortOrder` 'asc' | 'desc'

## Response `200`

Paginated sent-email history

- object
  - `success` boolean
  - `retentionDays` integer
  - `emailSends` object[]
    - `id` string
    - `companyId` string
    - `type` 'campaign' | 'transactional' | 'sequence', nullable — Send-source category. API/MCP sends use transactional here even when their delivery policy is marketing.
    - `emailType` 'marketing' | 'transactional', nullable — Delivery policy used for suppression and compliance behavior, or null when retained legacy data cannot prove it.
    - `isTransactional` boolean, nullable — Stored delivery-policy snapshot. Prefer emailType for a normalized value.
    - `isTestEmail` boolean — Whether this delivery was a test send hidden from normal sent-email history.
    - `campaignId` string, nullable
    - `transactionalEmailId` string, nullable
    - `automationNodeId` string, nullable
    - `automationTokenId` string, nullable
    - `abTestVariantId` string, nullable
    - `subscriberId` string, nullable
    - `subscriberExternalId` string, nullable — Customer-owned subscriber ID captured from a single-recipient transactional send.
    - `recipientEmail` string, email, nullable
    - `additionalRecipients` object, nullable — Full recipient envelope for multi-recipient transactional sends, as actually sent. Null for single-recipient sends.
      - `to` string[]
      - `cc` string[]
      - `bcc` string[]
    - `subject` string, nullable
    - `senderEmail` string, email, nullable
    - `senderName` string, nullable
    - `authenticatedDomainId` string, nullable
    - `originalReplyTo` string, nullable — Resolved reply destination, optionally including a display name. When reply tracking is disabled, this is the sent Reply-To header. When reply tracking is enabled, the sent header is a unique trackable address and this value is the forwarding destination.
    - `sendingIpAddress` string, nullable
    - `observedSendingIpAddress` string, nullable
    - `sesMessageId` string, nullable
    - `status` 'pending' | 'sent' | 'delivered' | 'opened' | 'clicked' | 'bounced' | 'complained' | 'failed' | 'suppressed'
    - `bounceType` string, nullable
    - `bounceSubType` string, nullable
    - `complaintType` string, nullable
    - `suppressionReason` 'bounced' | 'complaint' | 'unsubscribed', nullable
    - `errorMessage` string, nullable
    - `internalFailureCode` 'transport_exhausted' | 'admin_bounce', nullable — Why a send reached status "failed". Present only for terminal delivery failures. "transport_exhausted" means every available delivery route was refused by the recipient provider; "admin_bounce" means an operator removed the message from the delivery queue. Neither is a bounce: the address is still valid, stays subscribed, and is not suppressed.
    - `emailBody` string, nullable — Stored HTML body. Null when the email send row has been cleaned up.
    - `isCopiedRecipient` boolean — Whether this is an auxiliary CC/BCC delivery record whose content and engagement belong to a primary email send.
    - `primaryEmailSendId` string, nullable — Primary email send ID for a copied-recipient delivery, or null for ordinary sends and when the primary record is unavailable.
    - `sentAt` string, date-time, nullable
    - `deliveredAt` string, date-time, nullable
    - `bouncedAt` string, date-time, nullable
    - `complainedAt` string, date-time, nullable
    - `openedAt` string, date-time, nullable
    - `clickedAt` string, date-time, nullable
    - `unsubscribedAt` string, date-time, nullable
    - `suppressedAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `subscriber` object, nullable
      - `id` string
      - `email` string, email
      - `firstName` string, nullable
      - `lastName` string, nullable
    - `campaign` object, nullable
      - `id` string
      - `name` string
    - `automation` object, nullable
      - `id` string
      - `name` string
    - `eventAt` string, date-time
    - `opened` boolean
    - `clicked` boolean
  - `pagination` Pagination
    - `page` integer
    - `limit` integer
    - `total` integer
    - `totalPages` integer

## Other responses

- `400` — Invalid filter or pagination value
- `401` — Unauthorized
- `403` — No company selected

---

[API](https://skmtc.net/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.net/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/versions/af1cf9620482/schema)