> ## 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.

# predictions

> List and retrieve prediction results

The `vlmrun predictions` command lets you list and retrieve prediction results.

## List Predictions

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

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

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

# Pagination
vlmrun predictions list --limit 25 --skip 10
```

| Option     | 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 predictions since date (`YYYY-MM-DD`)                                          |
| `--until`  | Show predictions until date (`YYYY-MM-DD`)                                          |

## Get Prediction

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

# Wait for a prediction to complete (useful for batch jobs)
vlmrun predictions get <prediction-id> --wait

# Wait with custom timeout
vlmrun predictions get <prediction-id> --wait --timeout 120
```

| Argument/Option | Description                                            |
| --------------- | ------------------------------------------------------ |
| `PREDICTION_ID` | ID of the prediction to retrieve (required)            |
| `--wait`        | Wait for prediction to complete (default: `--no-wait`) |
| `--timeout`     | Timeout in seconds when waiting (default: `60`)        |