> ## 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.

# Get Transactional Email Metrics

> Get aggregate metrics, clicked links, bounce causes, complaints, replies, and human-versus-machine engagement for one saved transactional email.

# Get Transactional Email Metrics

Returns aggregate metrics for one saved transactional email selected by its ID
or API slug. Results are all-time by default. Open and click metrics exclude
detected machine engagement unless `includeMachineEngagement=true` is used.
The explicit `engagementBreakdown` always returns both human and machine counts.
Bounce types use the latest bounce event for each delivery, so permanent,
transient, and undetermined counts are mutually exclusive.

Direct-content Send API messages do not have a stable template identity. Use
account metrics with `emailType=transactional`, then search recent deliveries
through `GET /api/v1/email-sends` and inspect one by ID.

`GET /api/v1/transactional/{idOrSlug}/stats` is a compatibility alias.

## Parameters

<ParamField path="idOrSlug" type="string" required>
  Saved transactional email ID or API slug.
</ParamField>

<ParamField query="period" type="string">
  Optional sliding window: `1h`, `24h`, `7d`, `30d`, or `90d`.
</ParamField>

<ParamField query="start" type="string">
  ISO 8601 custom range start. Must be used with `end`.
</ParamField>

<ParamField query="end" type="string">
  ISO 8601 custom range end. Must be used with `start`; maximum 90 days.
</ParamField>

<ParamField query="includeMachineEngagement" type="boolean" default="false">
  Include detected scanners, previews, and tracked asset engagement.
</ParamField>

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/metrics/transactional/password-reset?period=30d" \
  -H "Authorization: Bearer API_KEY"
```

```json 200 theme={null}
{
  "success": true,
  "period": "30d",
  "transactional": {
    "id": "transactional_123",
    "name": "Password reset",
    "slug": "password-reset"
  },
  "stats": {
    "sent": 100,
    "delivered": 98,
    "bounced": 2,
    "opened": 72,
    "clicked": 45,
    "replies": 6,
    "complaints": 1,
    "deliveryRate": 98,
    "bounceRate": 2,
    "openRate": 73.47,
    "clickRate": 45.92,
    "replyRate": 6.12,
    "complaintRate": 1
  },
  "complaints": { "count": 1, "rate": 1 },
  "clickedLinks": [
    {
      "url": "https://example.com/reset",
      "clicks": 40,
      "percentage": 88.89
    }
  ],
  "bounceBreakdown": {
    "permanent": 1,
    "transient": 1,
    "undetermined": 0,
    "subtypes": [
      { "type": "Permanent", "subType": "General", "count": 1 },
      { "type": "Transient", "subType": "MailboxFull", "count": 1 }
    ]
  },
  "engagementBreakdown": {
    "human": { "opens": 72, "clicks": 45 },
    "machine": { "opens": 8, "clicks": 2 }
  }
}
```