---
title: "List evaluation runs"
method: GET
path: "/api/eval-runs/"
tags: ["eval-runs"]
---

# List evaluation runs

`GET /api/eval-runs/`

## Request

- Base URL: `https://api.overmindlab.ai`
- URL: `https://api.overmindlab.ai/api/eval-runs/`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - API key in cookie `sessionid`
  - API key in header `X-Api-Key`
  - HTTP bearer

## Query parameters

- `capability` string, uuid
- `created_after` string, date-time
- `created_before` string, date-time
- `dataset` string, uuid
- `group` string, uuid
- `is_baseline` boolean
- `mode` 'generate' | 'provided' | 'recorded'
- `ordering` string
- `page` integer
- `page_size` integer
- `project` string, uuid
- `search` string
- `status` 'cancelled' | 'completed' | 'failed' | 'pending' | 'running'

## Response `200`

- PaginatedEvalRunList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` EvalRun[], required
    - `id` string, uuid, required
    - `project` string, uuid, required
    - `name` string, required
    - `description` string, required
    - `label` string, required
    - `dataset` string, uuid, nullable, required
    - `dataset_name` string, required
    - `capability_id` string, uuid, required
    - `capability_name` string, required
    - `cell` string, uuid, nullable, required
    - `cell_info` object, nullable, required
    - `max_items` integer, required
    - `sampling` number, double, required
    - `eval_set` string, uuid, nullable, required
    - `matrix` unknown, required
    - `mode` 'recorded' | 'generate' | 'provided', required: * `recorded` - Recorded * `generate` - Generate * `provided` - Provided
    - `model_ref` string, uuid, nullable, required
    - `model_name` string, required
    - `resolved_model` string, required
    - `params` unknown, required
    - `group` string, uuid, required
    - `is_baseline` boolean, required
    - `judge_model` string, required
    - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled', required: * `pending` - Pending * `running` - Running * `completed` - Completed * `failed` - Failed * `cancelled` - Cancelled
    - `error` string, required
    - `summary` unknown, required
    - `progress` EvalRunProgress, required
      - `rows` integer, required
      - `waiting` integer, required
      - `running` integer, required
      - `done` integer, required
      - `errored` integer, required
      - `phase` 'preparing' | 'generating' | 'scoring', required: * `preparing` - preparing * `generating` - generating * `scoring` - scoring
    - `origin` string, required
    - `optimizer_experiment` string, uuid, nullable, required
    - `triggered_by` integer, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `completed_at` string, date-time, nullable, required

---

[API](https://skmtc.dev/overmindlab/apis/overmind-api.md) - [All operations](https://skmtc.dev/overmindlab/apis/overmind-api/llms.txt) - [OpenAPI document](https://skmtc.dev/overmindlab/apis/overmind-api/revisions/0ecfd39e80c6?raw)