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

# glasser runs list

> List Runs and filter the results.

## Usage

```bash theme={null}
glasser runs list
```

List runs, newest first.

## Flags

| Flag | Description |
| - | - |
| `--limit` | Maximum items to return (1-100; default 20) |
| `--cursor` | Pagination cursor from a previous response |
| `--status` | Filter by status: QUEUED, RUNNING, COMPLETED, FAILED, STOPPED |
| `--provider, -p` | Filter by provider |
| `--endpoint, -e` | Filter by endpoint |
| `--task` | Filter by the exact Task id, such as the `task_id` from a search response |

```bash theme={null}
glasser runs list --task <taskId>
```

See [CLI conventions](/docs/cli#global-flags) for global flags, JSON mode, exit codes, and environment variables.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.