---
title: "Stream outbound-delivery diagnostics as Server-Sent Events"
method: GET
path: "/api/live/delivery/{target}"
tags: ["Live Telemetry"]
---

# Stream outbound-delivery diagnostics as Server-Sent Events

`GET /api/live/delivery/{target}`

## Request

- Base URL: `https://mail.example.com`
- URL: `https://mail.example.com/api/live/delivery/{target}`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
  - API key in query parameter `token`
- TypeScript: <https://skmtc.dev/stalwartlabs/apis/stalwart-management-api/docs/api/live/delivery/:target/get.ts> (a function with typed inputs; its response is checked against the schema)

Opens a `text/event-stream` connection that streams each stage of an
outbound delivery attempt to `target` (a domain or email address): MX
lookup, MTA-STS fetch, TLSA/DANE validation, SMTP conversation, and so
on. Each SSE frame carries a JSON-encoded `DeliveryStage` wrapped in a
single-element array (`data: [{...}]`). The stream ends with a final
`completed` event. Requires `LiveDeliveryTest` permission; may also be
authenticated via the `?token=` query parameter obtained from
`/api/token/delivery`.

## Path parameters

- `target` string, required

## Query parameters

- `timeout` integer

## Response `200`

Server-Sent Events stream of delivery-diagnose stages

## Other responses

- `401`: Missing or invalid credentials
- `403`: Authenticated principal lacks the required permission

## Changes

- **2026-07-17** (v1) `a38a1bbfe8b2`: 1 info
  - endpoint added
- **2025-01-05** (v1) `fbbe298bfa82`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/stalwartlabs/apis/stalwart-management-api/changes/api/live/delivery/:target/get.md)

---

[API](https://skmtc.dev/stalwartlabs/apis/stalwart-management-api.md) - [All operations](https://skmtc.dev/stalwartlabs/apis/stalwart-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stalwartlabs/apis/stalwart-management-api/revisions/a38a1bbfe8b2?raw)