---
title: "List DLQ topics and their current size"
method: GET
path: "/dashboard/dlq"
tags: ["Dashboard"]
---

# List DLQ topics and their current size

`GET /dashboard/dlq`

## Request

- Base URL: `https://api.streamkap.com`
- URL: `https://api.streamkap.com/dashboard/dlq`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/streamkap/apis/streamkap-rest-api/docs/dashboard/dlq/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the tenant's Dead Letter Queue topics (source, destination and transform DLQs) with the number of messages each one currently retains, read from Kafka offsets. By default only DLQ topics holding messages are returned.

## Query parameters

- `include_empty` boolean: Also return DLQ topics with no messages
- `search` string, nullable: Substring match on topic name or owner name
- `page` integer: Page number (1-indexed)
- `page_size` integer: Results per page
- `sort` 'message_count' | 'name' | 'owner': Sort field values for the DLQ endpoint.
- `sort_dir` 'asc' | 'desc': Sort direction
- `include_last_message` boolean: Also fetch each returned topic's newest-message timestamp (slower: polls Kafka)

## Response `200`

Successful Response

- DashboardDlqRes: Response model for GET /dashboard/dlq.
  - `page` integer: Current page number
  - `page_size` integer: Results per page
  - `total` integer, nullable: Total number of results
  - `has_next` boolean, nullable: Whether more pages exist
  - `result` DlqTopicRes[]: DLQ topics for this page
    - `topic_id` string, required: Topic id, as used by the topic details page
    - `owner_type` 'source' | 'destination' | 'transform' | 'unknown', required: Entity that writes to a DLQ topic.
    - `owner_id` string, nullable: Source, destination or transform entity ID
    - `owner_name` string, nullable: Source, destination or transform display name
    - `owner_connector` string, nullable: Source/destination connector or transform type
    - `message_count` integer: Messages currently retained (sum of end - start offsets)
    - `partition_count` integer: Partitions on the broker; 0 if the topic is missing
    - `last_message_at` integer, nullable: Epoch ms of the newest message; null unless include_last_message=true
  - `total_with_messages` integer: DLQ topics retaining at least one message

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-01** `50e54c2e65f2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/streamkap/apis/streamkap-rest-api/changes/dashboard/dlq/get.md)

---

[API](https://skmtc.dev/streamkap/apis/streamkap-rest-api.md) - [All operations](https://skmtc.dev/streamkap/apis/streamkap-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/streamkap/apis/streamkap-rest-api/revisions/56dda39bb53c?raw)