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

# executions

> List and retrieve agent execution results

The `vlmrun executions` command lets you list and retrieve results from agent executions submitted via [`vlmrun execute`](/cli/execute) or the API.

## List Executions

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
# List recent executions (default: last 10)
vlmrun executions list

# Filter by status
vlmrun executions list --status completed
vlmrun executions list --status failed

# Filter by date range
vlmrun executions list --since 2026-03-01 --until 2026-03-30

# Pagination
vlmrun executions list --limit 25 --skip 10

# JSON output
vlmrun executions list -f json
```

| Option     | Short | Description                                                                         |
| ---------- | ----- | ----------------------------------------------------------------------------------- |
| `--limit`  |       | Max items to return (default: `10`)                                                 |
| `--skip`   |       | Number of items to skip (default: `0`)                                              |
| `--status` |       | Filter by status: `enqueued`, `pending`, `running`, `completed`, `failed`, `paused` |
| `--since`  |       | Show executions since date (`YYYY-MM-DD`)                                           |
| `--until`  |       | Show executions until date (`YYYY-MM-DD`)                                           |
| `--format` | `-f`  | Output format (`json`)                                                              |

## Get Execution

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
# Get execution details
vlmrun executions get <execution-id>

# Wait for an execution to complete
vlmrun executions get <execution-id> --wait

# Wait with custom timeout
vlmrun executions get <execution-id> --wait --timeout 120

# JSON output
vlmrun executions get <execution-id> -f json
```

| Argument/Option   | Short | Description                                           |
| ----------------- | ----- | ----------------------------------------------------- |
| `EXECUTION_ID`    |       | ID of the execution to retrieve (required)            |
| `--wait`          |       | Wait for execution to complete (default: `--no-wait`) |
| `--timeout`       |       | Timeout in seconds when waiting (default: `300`)      |
| `--poll-interval` |       | Seconds between status checks (default: `5`)          |
| `--format`        | `-f`  | Output format (`json`)                                |