---
title: "Get email send"
method: GET
path: "/email-sends/{emailSendId}"
tags: ["Email Sends"]
---

# Get email send

`GET /email-sends/{emailSendId}`

Gets an email delivery snapshot by ID, including queued and test sends, the stored HTML body when available, and retained ClickHouse events when the short-lived row has been cleaned up. Test sends remain hidden from sent-email history but are available through this exact-ID endpoint while their row is retained.

## Path parameters

- `emailSendId` string, required

## Response `200`

Email send found

- object
  - `success` boolean
  - `source` 'database' | 'clickhouse_events'
  - `message` string, nullable
  - `emailSend` EmailSend
    - `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' | 'crash_orphaned_claim', 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; "crash_orphaned_claim" means the sending worker stopped between claiming the send and recording a transport outcome, so the message was never confirmed as reaching the provider. None of them is a bounce: the address is still valid, stays subscribed, and is not suppressed. New codes can be added over time, so treat an unrecognized value as a generic failure rather than rejecting the response.
    - `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
  - `events` EmailSendEvent[]
    - `id` string
    - `emailSendId` string
    - `companyId` string
    - `campaignId` string, nullable
    - `transactionalEmailId` string, nullable
    - `subscriberId` string, nullable
    - `email` string, email, nullable
    - `emailName` string, nullable
    - `emailType` 'campaign' | 'transactional' | 'sequence', nullable — Send-source category retained for analytics compatibility. Use deliveryPolicy for the actual marketing or transactional policy.
    - `deliveryPolicy` 'marketing' | 'transactional', nullable — Delivery policy used for suppression and compliance behavior, or null when retained legacy events cannot prove it.
    - `abTestId` string, nullable
    - `abTestVariantId` string, nullable
    - `eventType` string
    - `bounceType` string, nullable
    - `bounceSubType` string, nullable
    - `complaintType` string, nullable
    - `clickedUrl` string, nullable
    - `ipAddress` string, nullable
    - `userAgent` string, nullable
    - `countryCode` string, nullable
    - `metadata` object
    - `eventTime` string, date-time

## Other responses

- `401` — Unauthorized
- `403` — No company selected
- `404` — Email send not found
- `500` — Internal server error
- `503` — The database was temporarily unavailable. The request may be retried after the delay in Retry-After.

## Changes

> 121 revisions in range; 9 could not be searched.

- **2026-08-19** `ba3a29c6eb33` — 5 info
  - added the optional property `retryable` to the response with the `401` status
  - added the optional property `retryable` to the response with the `403` status
  - added the optional property `retryable` to the response with the `404` status
  - added the optional property `retryable` to the response with the `500` status
  - …1 more
- **2026-08-18** `8fbabe82a04d` — 1 info
  - added the non-success response with the status `503`
- **2026-08-16** `6fd2903b91ce` — 4 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `500` status
- **2026-08-02** `36f92fc0caa2` — 4 breaking
  - the response property `success` became optional for the status `401`
  - the response property `success` became optional for the status `403`
  - the response property `success` became optional for the status `404`
  - the response property `success` became optional for the status `500`
- **2026-07-25** `b58891ac1cde` — 1 info
  - added the optional property `emailSend/internalFailureCode` to the response with the `200` status

[Full history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/email-sends/:emailSendId/get.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/73f826277d9a/schema)