> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Transactional Emails

> Search, filter, and sort transactional templates with their email subjects and delivery metrics.

List transactional email templates with the linked email subject and all-time
delivery metrics. Open and click metrics exclude detected machine engagement by
default.

## Query Parameters

<ParamField query="search" type="string">
  Case-insensitive search across template name, API slug, and email
  subject/title.
</ParamField>

<ParamField query="status" type="string" default="all">
  `all`, `active`, or `disabled`.
</ParamField>

<ParamField query="sort" type="string" default="date">
  `date`, `sends`, `opens`, `open-rate`, `clicks`, or `ctr`.
</ParamField>

<ParamField query="order" type="string" default="desc">
  `asc` or `desc`.
</ParamField>

<ParamField query="includeMachineEngagement" type="boolean" default="false">
  Include detected bots, scanners, previews, and privacy proxies in open and
  click metrics.
</ParamField>

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/transactional?search=welcome&status=active&sort=open-rate&order=desc" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "transactional": [
      {
        "id": "txn_abc123",
        "name": "Welcome Email",
        "slug": "welcome",
        "emailId": "email_abc123",
        "subject": "Welcome to Acme",
        "enabled": true,
        "stats": {
          "sends": 100,
          "deliveries": 98,
          "opens": 72,
          "clicks": 45,
          "bounces": 2,
          "openRate": 73.47,
          "clickRate": 45.92
        },
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z"
      },
      {
        "id": "txn_def456",
        "name": "Password Reset",
        "slug": "password-reset",
        "emailId": "email_def456",
        "subject": "Reset your password",
        "enabled": true,
        "stats": {
          "sends": 40,
          "deliveries": 40,
          "opens": 30,
          "clicks": 22,
          "bounces": 0,
          "openRate": 75,
          "clickRate": 55
        },
        "createdAt": "2024-01-14T08:00:00Z",
        "updatedAt": "2024-01-14T08:00:00Z"
      }
    ]
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized"
  }
  ```

  ```json 500 theme={null}
  {
    "success": false,
    "error": "Internal server error"
  }
  ```
</ResponseExample>