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

# Eval results

> List and retrieve completed eval results from the Lightsage CLI.

A result is the completed outcome of an eval execution. Run IDs and result IDs are separate. The result includes the judge outcome and supporting details.

## Commands

| Command | Description |
| - | - |
| `lightsage eval-results list` | List completed eval results. |
| `lightsage eval-results retrieve --result-id <result_id>` | Retrieve one result with details. |

## List eval results

```bash theme={null}
lightsage eval-results list --output-format json
```

Filter by time window:

```bash theme={null}
lightsage eval-results list --since 7d --limit 50
```

The `--since` flag accepts a relative window such as `7d` or an ISO timestamp.

## Retrieve one result

```bash theme={null}
lightsage eval-results retrieve --result-id result_123
```

The response includes the judge outcome, output, and diagnostic details.


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