> ## Documentation Index > Fetch the complete documentation index at: https://upstash.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List DLQ messages > List and paginate through all messages currently in the DLQ For multi-value filters, a message matches if its value equals any of the given values (OR logic), and multiple filters are combined with AND logic. Multiple values can be passed either by repeating the query parameter (`label=label_1&label=label_2`) or as a single comma-separated value (`label=label_1,label_2`). ## OpenAPI ````yaml /qstash/openapi.yaml get /v2/dlq openapi: 3.1.0 info: title: QStash REST API description: | QStash is a message queue and scheduler built on top of Upstash Redis. version: 2.0.0 contact: name: Upstash url: https://upstash.com servers: - url: https://qstash-{region}.upstash.io description: Regional variables: region: default: eu-central-1 enum: - us-east-1 - eu-central-1 security: - bearerAuth: [] - bearerAuthQuery: [] tags: - name: Messages description: Publish and manage messages - name: Queues description: Manage message queues - name: Schedules description: Create and manage scheduled messages - name: URL Groups description: Manage URL groups and endpoints - name: DLQ description: Dead Letter Queue operations - name: Logs description: Log operations - name: Signing Keys description: Manage signing keys - name: Flow Control description: Monitor flow control keys paths: /v2/dlq: get: tags: - DLQ summary: List DLQ messages description: List and paginate through all messages currently in the DLQ parameters: - name: cursor in: query schema: type: string description: >- By providing a cursor you can paginate through all of the messages in the DLQ - name: messageId in: query schema: type: string description: Filter DLQ messages by message ID - name: url in: query schema: type: array items: type: string description: Filter DLQ messages by destination URL. Supports multiple values. - name: topicName in: query schema: type: array items: type: string description: Filter DLQ messages by URL Group name. Supports multiple values. - name: scheduleId in: query schema: type: array items: type: string description: Filter DLQ messages by schedule ID. Supports multiple values. - name: queueName in: query schema: type: array items: type: string description: Filter DLQ messages by queue name. Supports multiple values. - name: fromDate in: query schema: type: integer format: int64 description: >- Filter DLQ messages by starting date, in milliseconds (Unix timestamp). This is inclusive. - name: toDate in: query schema: type: integer format: int64 description: >- Filter DLQ messages by ending date, in milliseconds (Unix timestamp). This is inclusive. - name: responseStatus in: query schema: type: array items: type: integer description: >- Filter DLQ messages by HTTP response status code of the last delivery attempt. Supports multiple values. - name: callerIp in: query schema: type: array items: type: string description: >- Filter DLQ messages by IP address of the publisher. Supports multiple values. - name: label in: query schema: type: array items: type: string description: > Filter DLQ messages by label. Supports multiple values. You can pass multiple values to match messages with any of the given labels (OR logic). Examples: - `label=my_label` - `label=label_1&label=label_2` - `label=label_1,label_2` - name: count in: query schema: type: integer default: 100 maximum: 100 description: The number of messages to return. responses: '200': description: List of DLQ messages content: application/json: schema: type: object properties: cursor: type: string description: > A cursor which you can use in subsequent requests to paginate through all messages. If no cursor is returned, you have reached the end of the messages. messages: type: array items: $ref: '#/components/schemas/DLQMessage' components: schemas: DLQMessage: type: object properties: messageId: type: string description: Unique identifier for the message url: type: string description: The URL to which the message should be delivered. topicName: type: string description: >- The URL Group (a.k.a. topic) name if this message was sent to a URL Group. endpointName: type: string description: >- The endpoint name of the message if the endpoint is given a name within the URL group. method: type: string description: The HTTP method to use for the message. header: type: object additionalProperties: type: array items: type: string description: The HTTP headers sent to your API. body: type: string description: >- The body of the message if it is composed of utf8 chars only, empty otherwise. bodyBase64: type: string description: >- The base64 encoded body if the body contains a non-utf8 char only, empty otherwise. maxRetries: type: integer description: >- The number of retries that should be attempted in case of delivery failure. notBefore: type: integer format: int64 description: >- The unix timestamp in milliseconds before which the message should not be delivered. createdAt: type: integer format: int64 description: The unix timestamp in milliseconds when the message was created. callback: type: string description: >- The url where we send a callback each time the message is attempted to be delivered. failureCallback: type: string description: The url where we send a callback to after the message is failed queueName: type: string description: The name of the queue if the message is enqueued to a queue. scheduleId: type: string description: >- The scheduleId of the message if the message is triggered by a schedule callerIP: type: string description: IP address of the publisher of this message. label: type: string deprecated: true description: >- The label of the message assigned by the user. Deprecated in favor of `labels`. labels: type: array items: type: string description: The list of labels assigned to the message by the user. flowControlKey: type: string description: The flow control key used for rate limiting. rate: type: integer description: The rate value used for flow control. period: type: integer description: The period value used for flow control. parallelism: type: integer description: The parallelism value used for flow control. responseStatus: type: integer description: The HTTP status code received from the destination API. responseHeader: type: object additionalProperties: type: array items: type: string description: The HTTP response headers received from the destination API. responseBody: type: string description: >- The body of the response if it is composed of utf8 chars only, empty otherwise. responseBodyBase64: type: string description: >- The base64 encoded body of the response if the body contains a non-utf8 char only, empty otherwise. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: QStash authentication token bearerAuthQuery: type: apiKey in: query name: qstash_token description: QStash authentication token passed as a query parameter ````