---
title: "List eval runs"
method: GET
path: "/v1/eval-runs"
tags: ["evals", "evals"]
---

# List eval runs

`GET /v1/eval-runs`

## Query parameters

- `session_id` string, uuid, nullable
- `evaluator_id` string, uuid, nullable
- `agent_id` string, uuid, nullable
- `status` 'pending' | 'running' | 'completed' | 'failed' | 'errored', nullable
- `scope` 'live' | 'simulation' | 'test', nullable
- `outcome` 'passed' | 'failed' | 'no_verdict' | 'errored', nullable
- `score_min` number, nullable — Min normalized score, matched against EvalScore.value [0,1]. numeric-format evaluators store their signal in raw_value (value is null), so they are not matched by score_min/score_max.
- `score_max` number, nullable — Max normalized score [0,1]; see score_min re: numeric evaluators.
- `severity` 'info' | 'low' | 'medium' | 'high' | 'critical', nullable
- `channel` string, nullable
- `created_from` string, date-time, nullable
- `created_to` string, date-time, nullable
- `limit` integer
- `cursor` string, nullable

## Response `200`

Successful Response

- CursorPageEvalRunResponse
  - `items` EvalRunResponse[], required
    - `id` string, uuid, required
    - `organization_id` string, uuid, required
    - `session_id` string, uuid, required
    - `evaluator_id` string, uuid, required
    - `agent_id` string, uuid, nullable
    - `channel` string, nullable
    - `status` string, required
    - `started_at` string, date-time, nullable, required
    - `finished_at` string, date-time, nullable, required
    - `error_text` string, nullable, required
    - `prompt_snapshot` string, nullable, required
    - `threshold_snapshot` number, nullable, required
    - `config_snapshot` object
    - `severity_snapshot` string, required
    - `format_snapshot` string, required
    - `is_critical_snapshot` boolean
    - `created_at` string, date-time, required
    - `scores` EvalScoreResponse[]
      - `id` string, uuid, required
      - `organization_id` string, uuid, required
      - `eval_run_id` string, uuid, required
      - `value` number, nullable, required
      - `raw_value` number, nullable, required
      - `label` string, nullable, required
      - `passed` boolean, nullable, required
      - `confidence` number, nullable, required
      - `rationale` string, nullable, required
      - `severity` string, nullable, required
      - `blocking` boolean, required
      - `evidence_observation_ids` string[]
      - `created_at` string, date-time, required
  - `next_cursor` string, nullable
  - `has_more` boolean, required

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/versions/888bdd5c076e/schema)