> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmodus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# modus workflows runs list

> List a workflow's past runs.

List a workflow's past runs.

## Usage

```bash theme={null}
modus workflows runs list [flags]
```

## Arguments

| Name |          | Description  |
| ---- | -------- | ------------ |
| `id` | required | Workflow id. |

## Flags

| Flag           | Type   | Description                                 |
| -------------- | ------ | ------------------------------------------- |
| `--status`     | string | Filter by run status.                       |
| `--search`     | string | Filter by search term.                      |
| `--page-size`  | string | Items per page (default 25, max 100).       |
| `--page-token` | string | Opaque page token from a previous response. |

Global: `--pretty` — human-readable table output instead of compact JSON.

See [CLI quickstart](/guides/cli) for install and auth.