---
title: "List recent sent emails"
method: GET
path: "/emails"
tags: ["Emails"]
---

# List recent sent emails

`GET /emails`

## Request

- Base URL: `https://api.supersendtx.com`
- URL: `https://api.supersendtx.com/emails`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Email list

- ListEmailsResponse
  - `emails` EmailListItem[], required
    - `id` string, required
    - `from` string, required
    - `to` string[], required
    - `cc` string[]
    - `bcc` string[]
    - `reply_to` string[]
    - `subject` string, required
    - `status` 'queued' | 'scheduled' | 'sent' | 'delivered' | 'delayed' | 'opened' | 'clicked' | 'bounced' | 'complained' | 'failed' | 'suppressed' | 'cancelled', required: Latest delivery state. `delayed` means delivery was deferred and has not completed yet. `opened` and `clicked` are set when tracking records engagement; they never replace `bounced`, `complained`, `failed`, or `suppressed`. `suppressed` means nothing was sent because a recipient is suppressed or opted out of the email's category.
    - `last_event` 'queued' | 'scheduled' | 'sent' | 'delivered' | 'delayed' | 'opened' | 'clicked' | 'bounced' | 'complained' | 'failed' | 'suppressed' | 'cancelled' | 'send_failed' | 'account_sending_blocked' | 'plan_limit', nullable: Most recent delivery event recorded for this email. `send_failed` means the mail server did not accept the message, `account_sending_blocked` and `plan_limit` mean the account could not send it. Unlike `status`, opens and clicks can appear here after a bounce.
    - `bounce_reason` string, nullable: Why delivery failed, as reported by the recipient's mail server. Set for bounces, complaints, and failed sends.
    - `tags` union
      - EmailTag[]
        - `name` string, required
        - `value` string, required
      - object
    - `scheduled_at` string, date-time, nullable
    - `cancelled_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `sent_at` string, date-time, nullable
    - `delivered_at` string, date-time, nullable
    - `bounced_at` string, date-time, nullable
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/ranla/apis/supersend-tx-api.md) · [All operations](https://skmtc.dev/ranla/apis/supersend-tx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ranla/apis/supersend-tx-api/revisions/e3e782652f50?raw)