{
  "schema_version": 2,
  "id": "integrate/redis-data-integration/reference/cli/redis-di-list-dlqs",
  "title": "redis-di list-dlqs",
  "url": "https://redis.io/docs/latest/integrate/redis-data-integration/reference/cli/redis-di-list-dlqs/",
  "summary": "Lists the dead-letter queues of a pipeline",
  "tags": [
    "redis-di"
  ],
  "last_updated": "2026-09-18T16:41:35+01:00",
  "page_type": "content",
  "content_hash": "558570d282622a3dfd49b2802e77821286525971cc8710b1e0a2677dbeffa957",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Lists the dead-letter queues (DLQs) of a pipeline with their record counts. A DLQ holds the records\nthat RDI rejected. Use\n[`list-dlq-records`](https://redis.io/docs/latest/integrate/redis-data-integration/reference/cli/redis-di-list-dlq-records)\nto read the records of a single queue.\n\nThere is one queue per source table, named `<source>.<qualified_table_name>`, where `<source>`\nis the source name from `config.yaml` and `<qualified_table_name>` is the qualified table name, \nsuch as `public.users` for PostgreSQL or `inventory.dbo.users` for SQL Server. See\n[Rejected records](https://redis.io/docs/latest/integrate/redis-data-integration/data-pipelines/rejected-records#how-rdi-stores-rejected-records)\nfor the form each database uses."
    },
    {
      "id": "usage",
      "title": "Usage",
      "role": "syntax",
      "text": "[code example]"
    },
    {
      "id": "options",
      "title": "Options",
      "role": "parameters",
      "text": "| Option             | Description                                          |\n| :----------------- | :--------------------------------------------------- |\n| `-p`, `--pipeline` | Pipeline to target (default `default`).              |\n| `-o`, `--output`   | Output format: `table` (default), `json`, or `yaml`. |\n\nThis command also accepts the\n[global options](https://redis.io/docs/latest/integrate/redis-data-integration/reference/cli/redis-di#global-options)."
    },
    {
      "id": "example",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    }
  ],
  "examples": [
    {
      "id": "usage-ex0",
      "language": "plaintext",
      "code": "redis-di list-dlqs [flags]",
      "section_id": "usage"
    },
    {
      "id": "example-ex0",
      "language": "bash",
      "code": "redis-di list-dlqs",
      "section_id": "example"
    }
  ]
}