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

# List sent emails

`GET /emails`

Retrieve a paginated list of sent emails. Results are ordered by
send time, newest first.

Use filters to narrow down results by status, recipient, sender, or tag.

**Related endpoints:**
- `GET /emails/{emailId}` - Get full details of a specific email
- `POST /emails` - Send a new email

## Query parameters

- `status` 'pending' | 'sent' | 'softfail' | 'hardfail' | 'bounced' | 'held'
- `to` string, email
- `from` string, email
- `tag` string
- `after` string
- `before` string
- `page` integer
- `perPage` integer

## Response `200`

List of emails

- ListEmailsResponse
  - `data` EmailSummary[], required — List of email summaries
    - `id` string, required — Unique message identifier (token)
    - `to` string, email, required
    - `from` string, required
    - `subject` string, required
    - `status` 'pending' | 'sent' | 'softfail' | 'hardfail' | 'bounced' | 'held', required — Current delivery status: - `pending` - Email accepted, waiting to be processed - `sent` - Email transmitted to recipient's mail server - `softfail` - Temporary delivery failure, will retry - `hardfail` - Permanent delivery failure - `bounced` - Email bounced back - `held` - Held for manual review
    - `tag` string
    - `timestamp` number, required
    - `timestampIso` string, date-time, required
  - `page` integer, required — Current page number (1-indexed)
  - `perPage` integer, required — Items per page
  - `total` integer, required — Total number of items
  - `totalPages` integer, required — Total number of pages
  - `meta` ApiMeta, required
    - `requestId` string, required — Unique request identifier for debugging and support

## Other responses

- `401` — Invalid or missing API key

---

[API](https://skmtc.net/arkhq-io/apis/ark-email-api.md) · [All operations](https://skmtc.net/arkhq-io/apis/ark-email-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkhq-io/ark-email-api/revisions/98a90852ffca/schema)