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

# List sent emails

`GET /v1/emails`

## Request

- Base URL: `https://smtpfa.st/api`
- URL: `https://smtpfa.st/api/v1/emails`
- Auth: HTTP bearer

List sent emails, newest first. Bodies are not included; fetch one with GET /v1/emails/{id}. Requires the email:read scope.

## Query parameters

- `limit` integer
- `page` integer
- `status` string
- `to` string
- `after` string
- `before` string

## Response `200`

A page of emails

- EmailList
  - `object` string, required
  - `data` EmailSummary[], required
    - `id` string, required
    - `from` string, required
    - `to` string[], required
    - `subject` string, required
    - `status` string, required: queued, scheduled, sending, sent, delivered, opened, clicked, bounced, complained, failed or canceled
    - `source` string, required: api, smtp, dashboard, broadcast or broadcast_test
    - `category` 'transactional' | 'marketing', required
    - `created_at` string, date-time, required
    - `sent_at` string, date-time, nullable, required
    - `delivered_at` string, date-time, nullable, required
    - `opened_at` string, date-time, nullable, required
    - `clicked_at` string, date-time, nullable, required
    - `bounced_at` string, date-time, nullable, required
    - `error_message` string, nullable, required
  - `page` integer: Absent when paging with after or before
  - `limit` integer, required
  - `total` integer, required: Emails matching the filters; with after or before, only those past that email
  - `has_more` boolean, required

## Other responses

- `401`: Invalid or missing API key
- `403`: Forbidden - domain not verified or insufficient permissions
- `429`: Rate limit exceeded - retry after the period indicated in the Retry-After header
- `500`: Internal server error

---

[API](https://skmtc.dev/smtpfa/apis/smtpfast-api.md) · [All operations](https://skmtc.dev/smtpfa/apis/smtpfast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smtpfa/apis/smtpfast-api/revisions/79dda742f53e?raw)