---
title: "List email events"
method: GET
path: "/v1/logs"
tags: ["Logs"]
---

# List email events

`GET /v1/logs`

## Request

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

The event log behind the dashboard Logs page: every lifecycle event of every sent email, newest first, with keyset pagination (after walks older, before walks newer, exclusive). Filter by event type, time window, recipient, domain, tag or email. Received mail is not in this log; use GET /v1/emails/receiving. Requires the logs:read scope.

## Query parameters

- `limit` integer
- `after` string
- `before` string
- `type` string
- `since` string, date-time
- `until` string, date-time
- `recipient` string
- `domain` string
- `domain_id` string
- `tag` string
- `email_id` string

## Response `200`

Email events

- object
  - `object` string
  - `has_more` boolean
  - `data` LogEvent[]
    - `object` string
    - `id` string
    - `type` string
    - `created_at` string, date-time
    - `email_id` string
    - `from` string
    - `to` string[]
    - `subject` string
    - `domain_id` string, nullable
    - `tags` object[]
      - `name` string
      - `value` string
    - `data` object: Event details: bounce type, clicked URL, error message, and similar

## Other responses

- `400`: Bad request - check your payload
- `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)