---
title: "Peek at dead letter queue messages"
method: GET
path: "/api/admin/queues/deadletter/messages"
tags: ["Dead Letter Queue"]
---

# Peek at dead letter queue messages

`GET /api/admin/queues/deadletter/messages`

Retrieves messages from the dead letter queue without removing them. This endpoint is feature-gated and only available when AdminEndpointsEnabled is true.

## Query parameters

- `maxMessages` integer

## Response `200`

OK - Messages retrieved

- DeadLetterMessagesResult
  - `messages` DeadLetterMessage[]
    - `messageId` string
    - `originalMessageId` string, nullable
    - `failureReason` string, nullable
    - `failureMessage` string, nullable
    - `failureTimestamp` string, nullable
    - `receiveCount` string, nullable
    - `correlationId` string, nullable
    - `messageType` string, nullable
    - `body` string
  - `totalApproximateCount` integer
  - `checkedAt` string, date-time

## Other responses

- `400` — Bad Request - DLQ URL not configured
- `503` — Service Unavailable - Unable to reach the dead letter queue

---

[API](https://skmtc.dev/defra/apis/livestock-keeper-data-api-internal.md) · [All operations](https://skmtc.dev/defra/apis/livestock-keeper-data-api-internal/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/defra/livestock-keeper-data-api-internal/revisions/bfd8eb077a9b/schema)