---
title: "List transactional emails"
method: GET
path: "/transactional"
tags: ["Transactional"]
---

# List transactional emails

`GET /transactional`

Lists transactional email templates with their linked subjects and all-time delivery metrics. Search name, slug, or subject; filter active state; and sort by engagement. Human engagement is used by default.

## Query parameters

- `search` string
- `status` 'all' | 'active' | 'disabled'
- `sort` 'date' | 'sends' | 'opens' | 'open-rate' | 'clicks' | 'ctr'
- `order` 'asc' | 'desc'
- `includeMachineEngagement` boolean

## Response `200`

Successful response

- object
  - `success` boolean
  - `transactional` TransactionalEmailListItem[]
    - `id` string
    - `name` string
    - `slug` string
    - `emailId` string
    - `enabled` boolean
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `subject` string, nullable
    - `emailPreset` 'branded' | 'minimal', nullable — Per-email Style > Format, derived from the stored blocks. `branded` renders the company logo and the full footer; `minimal` renders no logo and the simple footer. Null when the entire email is a single raw HTML block, which has no Sequenzy format. Sequence steps, campaigns, transactional templates, and saved templates all report this field, so chrome can be compared across emails without rendering them.
    - `stats` object
      - `sends` integer
      - `deliveries` integer
      - `opens` integer
      - `clicks` integer
      - `bounces` integer
      - `openRate` number, float
      - `clickRate` number, float

## Other responses

- `401` — Unauthorized
- `500` — Internal server error
- `503` — The database was temporarily unavailable. The request may be retried after the delay in Retry-After.

## Changes

- **2026-08-18** `8fbabe82a04d` — 1 info
  - added the non-success response with the status `503`
- **2026-08-16** `6fd2903b91ce` — 2 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `500` status
- **2026-08-08** `af1cf9620482` — 1 info
  - added the optional property `transactional/items/allOf[subschema #2]/emailPreset` to the response with the `200` status
- **2026-08-02** `36f92fc0caa2` — 2 breaking
  - the response property `success` became optional for the status `401`
  - the response property `success` became optional for the status `500`
- **2026-07-22** `06219e920c39` — 1 breaking, 7 warning, 6 info
  - the `transactional/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `transactional/items/createdAt` from the response with the `200` status
  - removed the optional property `transactional/items/emailId` from the response with the `200` status
  - removed the optional property `transactional/items/enabled` from the response with the `200` status
  - …10 more

[Full history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/transactional/get.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/8fbabe82a04d/schema)