{
  "schema_version": 2,
  "id": "integrate/redis-data-integration/reference/cli/redis-di-list-dlq-records",
  "title": "redis-di list-dlq-records",
  "url": "https://redis.io/docs/latest/integrate/redis-data-integration/1.19.1/reference/cli/redis-di-list-dlq-records/",
  "summary": "Lists the rejected records of a dead-letter queue",
  "content": "\nLists the rejected records of a single dead-letter queue (DLQ), taking the queue name as an argument\nand paging with `--limit`, `--offset`, and `--sort-order`. The operation code is shown by name\n(create, update, delete, read). `get-rejected` is an alias for this command.\n\nUse [`list-dlqs`](https://redis.io/docs/latest/integrate/redis-data-integration/1.19.1/reference/cli/redis-di-list-dlqs)\nto see all the pipeline's dead-letter queues and their record counts.\n\n## Usage\n\n```\nredis-di list-dlq-records \u003cdlq-name\u003e [flags]\n```\n\n## Options\n\n| Option             | Description                                                         |\n| :----------------- | :------------------------------------------------------------------ |\n| `-p`, `--pipeline` | Pipeline to target (default `default`).                             |\n| `--limit`          | Maximum number of records to return (default `20`).                 |\n| `--offset`         | Number of records to skip (default `0`).                            |\n| `--sort-order`     | Sort order: `asc` (oldest first) or `desc` (newest first, default). |\n| `-o`, `--output`   | Output format: `table` (default), `json`, or `yaml`.                |\n\nThe following options are kept for backward compatibility with the `get-rejected` command and are\ndeprecated:\n\n| Deprecated option | Use instead                       |\n| :---------------- | :-------------------------------- |\n| `--dlq-name`      | Pass the DLQ name as an argument. |\n| `--max-records`   | `--limit`                         |\n| `--oldest`        | `--sort-order asc`                |\n\nThis command also accepts the\n[global options](https://redis.io/docs/latest/integrate/redis-data-integration/1.19.1/reference/cli/redis-di#global-options).\n\n## Example\n\n```bash\n# Newest 20 rejected records of a queue\nredis-di list-dlq-records inventory.customers\n\n# Oldest 100 records, as JSON\nredis-di list-dlq-records inventory.customers --limit 100 --sort-order asc -o json\n```\n",
  "tags": ["redis-di"],
  "last_updated": "2026-09-19T17:55:58-07:00"
}