> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Email Send

> Get a sent email snapshot, HTML body, and event timeline by emailSendId.

# Get Email Send

You can retrieve a sent email by `emailSendId`. Email send rows are cleaned up after 14 days; when the row is gone, the API returns retained ClickHouse events and a sparse summary without `emailBody`. Test sends are hidden from sent-email history and return `404` from this endpoint, while still counting toward send usage and quota.

## Request

<ParamField path="emailSendId" type="string" required>
  Email send ID.
</ParamField>

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/email-sends/send_123" \
  -H "Authorization: Bearer API_KEY"
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "source": "database",
    "emailSend": {
      "id": "send_123",
      "companyId": "company_123",
      "type": "transactional",
      "recipientEmail": "user@example.com",
      "subscriberExternalId": "customer_123",
      "subject": "Welcome",
      "senderEmail": "hello@example.com",
      "senderName": "Acme",
      "status": "delivered",
      "suppressionReason": null,
      "emailBody": "<html><body><p>Welcome</p></body></html>",
      "sentAt": "2026-05-01T12:00:00.000Z",
      "deliveredAt": "2026-05-01T12:00:03.000Z",
      "suppressedAt": null,
      "createdAt": "2026-05-01T11:59:58.000Z"
    },
    "events": [
      {
        "id": "evt_123",
        "emailSendId": "send_123",
        "eventType": "delivery",
        "eventTime": "2026-05-01T12:00:03.000Z"
      }
    ]
  }
  ```

  ```json 200 theme={null}
  {
    "success": true,
    "source": "clickhouse_events",
    "message": "Email send row was not found; returned retained ClickHouse event data. The HTML body is unavailable after email send cleanup.",
    "emailSend": {
      "id": "send_123",
      "companyId": "company_123",
      "type": "campaign",
      "recipientEmail": "user@example.com",
      "subject": "Spring launch",
      "status": "clicked",
      "emailBody": null,
      "sentAt": "2026-04-01T10:00:00.000Z",
      "clickedAt": "2026-04-01T10:05:00.000Z",
      "createdAt": "2026-04-01T10:00:00.000Z"
    },
    "events": [
      {
        "id": "evt_send",
        "emailSendId": "send_123",
        "eventType": "send",
        "eventTime": "2026-04-01T10:00:00.000Z"
      },
      {
        "id": "evt_click",
        "emailSendId": "send_123",
        "eventType": "click",
        "clickedUrl": "https://example.com",
        "eventTime": "2026-04-01T10:05:00.000Z"
      }
    ]
  }
  ```

  ```json 200 theme={null}
  {
    "success": true,
    "source": "database",
    "emailSend": {
      "id": "send_suppressed",
      "companyId": "company_123",
      "type": "campaign",
      "recipientEmail": "bounced@example.com",
      "subject": "Spring launch",
      "status": "suppressed",
      "suppressionReason": "bounced",
      "errorMessage": "Email suppressed due to previous bounce (bounced_email)",
      "sentAt": null,
      "suppressedAt": "2026-05-01T12:00:00.000Z",
      "createdAt": "2026-05-01T11:59:58.000Z"
    },
    "events": []
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Missing API key. Provide via x-api-key header or Authorization: Bearer <key>"
  }
  ```

  ```json 403 theme={null}
  { "success": false, "error": "No company selected" }
  ```

  ```json 404 theme={null}
  { "success": false, "error": "Email send not found" }
  ```

  ```json 500 theme={null}
  { "success": false, "error": "Internal server error" }
  ```
</ResponseExample>
