> ## Documentation Index
> Fetch the complete documentation index at: https://upstash-partnerstash.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# client.dlq.list

The `dlq.list` method retrieves messages that were sent to the **Dead Letter Queue (DLQ)**.

DLQ messages represent failed workflow or QStash deliveries that could not be retried successfully.

## Arguments

<ParamField body="cursor" type="string" optional>
  A pagination cursor from a previous request.
  Use this to fetch the next batch of results.
</ParamField>

<ParamField body="count" type="number" optional>
  Maximum number of DLQ messages to return.
  Defaults to a system-defined limit if not provided.
</ParamField>

<ParamField body="filter" type="object" optional>
  Filter options for narrowing down DLQ messages

  <Expandable defaultOpen>
    <ParamField body="fromData" type="number">
      Earliest timestamp (Unix ms) to include.
    </ParamField>

    <ParamField body="toDate" type="number">
      Latest timestamp (Unix ms) to include.
    </ParamField>

    <ParamField body="url" type="number">
      Filter messages that targeted a specific URL.
    </ParamField>

    <ParamField body="responseStatus" type="number">
      Filter by HTTP response status code.
    </ParamField>
  </Expandable>
</ParamField>

## Response

<ResponseField name="messages" type="DLQMessage[]">
  An array of DLQ messages that match the provided filters.
</ResponseField>

<ResponseField name="cursor" type="string">
  A cursor to paginate through additional results.
  If not returned, you have reached the end of the DLQ.
</ResponseField>

## Usage

```ts theme={null}
import { Client } from "@upstash/workflow";

const client = new Client({ token: "<QSTASH_TOKEN>" });

// 👇 List all DLQ messages
const { messages, cursor } = await client.dlq.list({ filter: dlqFilters });

// 👇 List with pagination and filtering
const result = await client.dlq.list({
  cursor,
  count: 10,
  filter: {
    fromDate: Date.now() - 86400000, // last 24 hours
    toDate: Date.now(),
    url: "https://your-endpoint.com",
    responseStatus: 500
  }
});

```