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

# List Sent Emails

`GET /emails`

## Request

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

Retrieve a paginated list of sent emails. Supports filtering by recipient email and date range. Uses cursor-based pagination.

## Query parameters

- `per_page` integer
- `cursor` string
- `recipients` string, email
- `from` string, date
- `to` string, date

## Response `200`

Emails retrieved successfully

- ListEmailsResponse
  - `message` string, required
  - `data` object, required
    - `events` object, required
      - `data` SentEmailListItem[], required
        - `event_id` string, required
        - `type` string, required: SparkPost event type (e.g., injection)
        - `timestamp` string, date-time, required
        - `request_id` string, nullable
        - `message_id` string, nullable
        - `subject` string, nullable
        - `friendly_from` string, nullable
        - `sending_domain` string, nullable
        - `rcpt_to` string, nullable
        - `raw_rcpt_to` string, nullable
        - `recipient_domain` string, nullable
        - `mailbox_provider` string, nullable
        - `mailbox_provider_region` string, nullable
        - `sending_ip` string, nullable
        - `click_tracking` boolean, nullable
        - `open_tracking` boolean, nullable
        - `transactional` boolean, nullable
        - `msg_size` integer, nullable
        - `injection_time` string, date-time, nullable
        - `rcpt_meta` object, nullable
      - `total_count` integer, required: Total number of matching emails
      - `from` string, date-time, required: Start of the query date range
      - `to` string, date-time, required: End of the query date range
      - `pagination` object, required
        - `next_cursor` string, nullable: Cursor for the next page, or null if no more results
        - `per_page` integer

## Other responses

- `400`: Retrieval error (e.g., sandbox key without associated user)
- `401`: Unauthorized
- `422`: Validation error
- `500`: Server error
- `503`: Service unavailable - the API key could not be verified, so the request was not processed. This does not mean the key is invalid; retry after the delay given in the Retry-After header.

---

[API](https://skmtc.dev/lettr/apis/lettr-api.md) · [All operations](https://skmtc.dev/lettr/apis/lettr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lettr/apis/lettr-api/revisions/48ef0dac1ebd?raw)