---
title: "ezgh workflows runs list"
description: "Search the project's runs, newest first."
---

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

# ezgh workflows runs list

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh workflows runs list [--app a] [--workflow w] [--status s]… [--schedule s] [--parent run] [--run-key k] [--created-after t] [--created-before t] [flags]
```

List the project's runs, newest first, narrowed by any of the filters (all must match; `--status` can be repeated, or comma-separated, and matches any of them: running, cancelling, completed, failed, cancelled, timedOut). `--created-after` and `--created-before` take RFC 3339, a date, or a duration ago (15m, 2h, 7d), and leave the time itself out.

The list lags changes by about a second; `ezgh workflows runs get` is always current. A page's `--cursor` goes with the filters it was listed with.

Part of [`ezgh workflows runs`](/cli/reference/workflows-runs).

## Examples

```sh
ezgh workflows runs list --status failed,timedOut --created-after 24h
ezgh workflows runs list --app web --workflow onboard --all -o json
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--all` | boolean |  | follow nextCursor through every page |
| `--app` | string |  | only this app's runs (by ID, slug or name) |
| `--created-after` | string |  | only runs created after this time |
| `--created-before` | string |  | only runs created before this time |
| `--cursor` | string |  | start from this page (a previous page's nextCursor) |
| `--limit` | int | `50` | items per page, 1 to 100 |
| `--parent` | string |  | only child runs of this run (its ID) |
| `--run-key` | string |  | only the run with this run key |
| `--schedule` | string |  | only runs this schedule started (by ID or name) |
| `--status` | strings, comma-separated or repeated |  | only runs with this status (repeat, or comma-separate, for any of several) |
| `--workflow` | string |  | only this workflow's runs |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/workflows-runs-list/index.mdx