---
title: "Get a specific evaluation run by ID"
method: GET
path: "/v1/observability/evaluation-runs_v2/{run_id}"
tags: ["beta.observability.evaluations.runs"]
---

# Get a specific evaluation run by ID

`GET /v1/observability/evaluation-runs_v2/{run_id}`

## Request

- Base URL: `https://api.mistral.ai`
- URL: `https://api.mistral.ai/v1/observability/evaluation-runs_v2/{run_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/mistral/apis/mistral-ai-api/docs/v1/observability/evaluation-runs_v2/:run_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a specific evaluation run by ID

## Path parameters

- `run_id` string, uuid, required

## Response `200`

Successful Response

- EvaluationRunV2Response
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `deleted_at` string, date-time, nullable, required
  - `creator_id` string, uuid, required
  - `evaluation_id` string, uuid, required
  - `name` string, required
  - `description` string, nullable, required
  - `tags` string[], required
  - `metadata_` object, required
  - `num_generations` integer, required
  - `run_info` object, nullable
  - `status` string
  - `dataset_id` string, uuid, nullable
  - `evaluators` EvaluatorV2[], required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `deleted_at` string, date-time, nullable, required
    - `name` string, required
    - `description` string, nullable, required
    - `tags` string[], required
    - `num_scores` integer, required
    - `goal` GoalSpec
      - `operator` string, nullable
      - `value` unknown
      - `min` number, nullable
      - `max` number, nullable
      - `values` JsonValue[], nullable
        - unknown
      - `metric` string, nullable
    - `aggregate_goal` GoalSpec
      - `operator` string, nullable
      - `value` unknown
      - `min` number, nullable
      - `max` number, nullable
      - `values` JsonValue[], nullable
        - unknown
      - `metric` string, nullable
    - `statistics` union[], nullable
      - union
        - SimpleNumericStatisticSpec: A scalar numeric reduction with no parameters (``avg``/``sum``/``min``/``max``/``std``/``count``).
          - `kind` 'avg' | 'sum' | 'min' | 'max' | 'std' | 'count', required
          - `goal` GoalSpec
            - `operator` string, nullable
            - `value` unknown
            - `min` number, nullable
            - `max` number, nullable
            - `values` JsonValue[], nullable
              - …
            - `metric` string, nullable
        - PercentileStatisticSpec: The ``p``-th percentile (``0 <= p <= 100``), computed with the type-7 algorithm.
          - `kind` 'percentile'
          - `percentile` union, required
            - number
            - integer
          - `goal` GoalSpec
            - `operator` string, nullable
            - `value` unknown
            - `min` number, nullable
            - `max` number, nullable
            - `values` JsonValue[], nullable
              - …
            - `metric` string, nullable
        - ClassificationStatisticSpec: A classification metric (``precision``/``recall``/``f1``) over ``(expected, predicted)`` pairs. The predicted label is the score ``value``; the expected label is read from the score ``metadata`` under ``expected_key`` (default ``"expected"``). Provide **exactly one** of ``positive_label`` (a binary metric scored against that one class) or ``average`` (a multi-class averaging scheme). ``labels`` pins the class universe so filtered views keep a stable, comparable denominator.
          - `kind` 'precision' | 'recall' | 'f1', required
          - `positive_label` string, nullable
          - `average` 'macro' | 'micro' | 'weighted', nullable
          - `expected_key` string
          - `labels` string[], nullable
          - `goal` GoalSpec
            - `operator` string, nullable
            - `value` unknown
            - `min` number, nullable
            - `max` number, nullable
            - `values` JsonValue[], nullable
              - …
            - `metric` string, nullable
    - `weight` number
    - `direction` 'maximize' | 'minimize', nullable
    - `min_value` number, nullable
    - `max_value` number, nullable
  - `run_evaluators` EvaluatorV2[]
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `deleted_at` string, date-time, nullable, required
    - `name` string, required
    - `description` string, nullable, required
    - `tags` string[], required
    - `num_scores` integer, required
    - `goal` GoalSpec
      - `operator` string, nullable
      - `value` unknown
      - `min` number, nullable
      - `max` number, nullable
      - `values` JsonValue[], nullable
        - unknown
      - `metric` string, nullable
    - `aggregate_goal` GoalSpec
      - `operator` string, nullable
      - `value` unknown
      - `min` number, nullable
      - `max` number, nullable
      - `values` JsonValue[], nullable
        - unknown
      - `metric` string, nullable
    - `statistics` union[], nullable
      - union
        - SimpleNumericStatisticSpec: A scalar numeric reduction with no parameters (``avg``/``sum``/``min``/``max``/``std``/``count``).
          - `kind` 'avg' | 'sum' | 'min' | 'max' | 'std' | 'count', required
          - `goal` GoalSpec
            - `operator` string, nullable
            - `value` unknown
            - `min` number, nullable
            - `max` number, nullable
            - `values` JsonValue[], nullable
              - …
            - `metric` string, nullable
        - PercentileStatisticSpec: The ``p``-th percentile (``0 <= p <= 100``), computed with the type-7 algorithm.
          - `kind` 'percentile'
          - `percentile` union, required
            - number
            - integer
          - `goal` GoalSpec
            - `operator` string, nullable
            - `value` unknown
            - `min` number, nullable
            - `max` number, nullable
            - `values` JsonValue[], nullable
              - …
            - `metric` string, nullable
        - ClassificationStatisticSpec: A classification metric (``precision``/``recall``/``f1``) over ``(expected, predicted)`` pairs. The predicted label is the score ``value``; the expected label is read from the score ``metadata`` under ``expected_key`` (default ``"expected"``). Provide **exactly one** of ``positive_label`` (a binary metric scored against that one class) or ``average`` (a multi-class averaging scheme). ``labels`` pins the class universe so filtered views keep a stable, comparable denominator.
          - `kind` 'precision' | 'recall' | 'f1', required
          - `positive_label` string, nullable
          - `average` 'macro' | 'micro' | 'weighted', nullable
          - `expected_key` string
          - `labels` string[], nullable
          - `goal` GoalSpec
            - `operator` string, nullable
            - `value` unknown
            - `min` number, nullable
            - `max` number, nullable
            - `values` JsonValue[], nullable
              - …
            - `metric` string, nullable
    - `weight` number
    - `direction` 'maximize' | 'minimize', nullable
    - `min_value` number, nullable
    - `max_value` number, nullable
  - `system` SystemV2
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `deleted_at` string, date-time, nullable, required
    - `name` string, required
    - `params` object, required
  - `statistics` object
  - `goal_results` object
  - `passed` boolean, nullable
  - `run_scores` object
  - `optimization` RunOptimizationRef: Typed run→optimization back-ref, derived at read from the optimization_run link. Not stored on the run (single source of truth = optimization_run); lets a run row show its optimization (id + name) without an extra request per run.
    - `optimization_id` string, uuid, required
    - `name` string, required

## Other responses

- `400`: Bad Request - Invalid request parameters or data
- `404`: Not Found - Resource does not exist
- `408`: Request Timeout - Operation timed out
- `409`: Conflict - Resource conflict
- `422`: Unprocessable Entity - Validation error

## Changes

- **2026-10-12** `6c349f3bdef6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/observability/evaluation-runs_v2/:run_id/get.md)

---

[API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) - [All operations](https://skmtc.dev/mistral/apis/mistral-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mistral/apis/mistral-ai-api/revisions/08a585fb75bc?raw)