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

# Prompt runs

> List and retrieve stored prompt runs from the Lightsage CLI.

Prompt run commands retrieve stored results from executed Visibility prompts. They do not start new prompt runs.

## Commands

| Command | Description |
| - | - |
| `lightsage prompts runs list` | List prompt runs. |
| `lightsage prompts runs retrieve --run-id <run_id>` | Retrieve one prompt run. |

## List prompt runs

```bash theme={null}
lightsage prompts runs list --output-format json
```

Filter by prompt, platform, or date range:

```bash theme={null}
lightsage prompts runs list \
  --prompt-id prompt_123 \
  --platform-id chatgpt \
  --start-date 2026-09-01 \
  --end-date 2026-09-06
```

Use `--limit` and `--offset` for pagination:

```bash theme={null}
lightsage prompts runs list --limit 10 --offset 20
```

## Retrieve one prompt run

```bash theme={null}
lightsage prompts runs retrieve --run-id run_123
```

The response includes the run's mentions and citations without exposing raw provider payloads or internal configuration.


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