---
title: "listOutboundDlqMessages"
method: GET
path: "/v1/integrations/{integrationId}/outbound/messages/dlq"
tags: ["integrations"]
---

# listOutboundDlqMessages

`GET /v1/integrations/{integrationId}/outbound/messages/dlq`

List an integration's dead-lettered outbound queue messages
(poison_policy enforcement and operator skips move messages here).
Operator endpoint — requires the `integration:manage` grant. Message
payloads are NOT included in listings: entries are keyed by the
opaque message id and carry delivery metadata only. Paginated via an
opaque `next_token`.

## Path parameters

- `integrationId` string, uuid, required

## Query parameters

- `limit` integer
- `next_token` string

## Response `200`

Page of dead-lettered messages

- OutboundDlqListResponse
  - `items` OutboundDlqMessage[], required — Dead-lettered messages, oldest first
    - `id` string, required — Opaque message id (msg_…) of the dead-lettered message
    - `use_case_id` string, required — The poll-mode use case that produced this message
    - `event_name` string, required — Standardized event name (e.g. contract.updated)
    - `event_id` string, required — Unique id of the originating event
    - `enqueued_at` string, date-time — When the message was originally enqueued
    - `dead_lettered_at` string, date-time, required — When the message was dead-lettered
    - `delivery_attempts` integer, required — Delivery attempts at the moment the message was dead-lettered
    - `reason` string — Why the message was dead-lettered (policy or operator reason)
    - `expires_at` string, date-time — When the DLQ entry expires (retention window re-armed at dead-letter time)
  - `next_token` string — Opaque pagination token — present when more entries exist

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `403` — Forbidden - insufficient permissions
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/epilot/apis/integration-toolkit-api.md) · [All operations](https://skmtc.net/epilot/apis/integration-toolkit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/integration-toolkit-api/revisions/c24837d75096/schema)