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

# workflows runs

> List workflow runs for this app

List runs across all of this app's [workflows](/Building-your-app/Creating-workflows), newest first. This includes scheduled, manual, and test runs, not just runs triggered automatically.

## Usage

```bash theme={null}
base44 workflows runs
```

## Flags

| Flag                 | Description                                                                                                             |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `--status <status>`  | Filter to runs in this state. One of `running`, `completed`, `failed`, `cancelled`.                                     |
| `--since <datetime>` | Show runs started at or after this time. Accepts an ISO 8601 datetime or a relative duration like `1h`, `30m`, or `2d`. |
| `-n, --limit <n>`    | Number of runs to return, between `1` and `200`. Defaults to `30`.                                                      |
| `--json`             | Output the runs as JSON. See [JSON output](/developers/references/cli/commands/introduction#json-output).               |

## Example

```bash theme={null}
base44 workflows runs --status failed --since 1h
```

## Output format

Each line shows the run's start time, status, and workflow name, followed by its trigger type and duration:

```
2026-08-30 08:40:00 RUNNING   Onboarding email  (entity)
2026-08-30 08:55:03 FAILED    Retry webhook sync  (webhook, test)  1.2s [rate-limited]
    Upstream API returned 429 after 3 retries
2026-08-30 09:00:12 COMPLETED Weekly digest  (scheduled)  4.2s
```

A run tagged `test` was started manually instead of by its usual trigger. Failed and cancelled runs show the failure reason in brackets, followed by the underlying error message on the next line when one was captured.

## See also

* [`workflows list`](/developers/references/cli/commands/workflows-list): List this app's workflows
* [Creating workflows](/Building-your-app/Creating-workflows): Learn about workflows and how they run