---
title: "Get an evaluation run"
method: GET
path: "/api/eval-runs/{id}/"
tags: ["eval-runs"]
---

# Get an evaluation run

`GET /api/eval-runs/{id}/`

## Request

- Base URL: `https://api.overmindlab.ai`
- URL: `https://api.overmindlab.ai/api/eval-runs/{id}/`
- 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

## Path parameters

- `id` string, uuid, required

## Response `200`

- EvalRunDetail
  - `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
  - `context_checks` EvaluationContextCheck[], required
    - `role` string, required
    - `label` string, required
    - `model` string, required
    - `context_window` integer, nullable, required
    - `max_output_tokens` integer, nullable, required
    - `estimated_input_tokens` integer, required
    - `total_input_tokens` integer
    - `configured_model` string
    - `reserved_output_tokens` integer, required
    - `required_context` integer, required
    - `checked_rows` integer, required
    - `affected_rows` integer, required
    - `row_indices` integer[], required
    - `estimated` boolean, required
    - `status` string, required
    - `message` string, required
    - `estimated_cost_usd` number, double, nullable
    - `cost_basis` string
    - `suggestions` EvaluationContextSuggestion[]
      - `model` string, required
      - `name` string, required
      - `context_window` integer, required
      - `max_output_tokens` integer, required
      - `reserved_output_tokens` integer, required
      - `estimated_cost_usd` number, double, nullable, required
      - `cost_delta_usd` number, double, nullable, required
    - `suggestion_note` string

---

[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)