---
title: "Get Run Results"
method: GET
path: "/api/v1/optimization/runs/{run_id}/results"
tags: ["optimization"]
---

# Get Run Results

`GET /api/v1/optimization/runs/{run_id}/results`

Return per-example evaluation results for an optimization run.

## Path parameters

- `run_id` string, required — Identifier of the optimization run whose results to list.

## Query parameters

- `limit` integer — Maximum number of evaluation rows to return.
- `offset` integer — Pagination offset into the evaluation results.

## Response `200`

Successful Response

- EvaluationResultsResponse — Paginated evaluation results for a run.
  - `items` EvaluationResultItem[], required — Evaluation result items.
    - `id` string, required — Unique evaluation result identifier.
    - `example_index` integer, required — Zero-based index in the dataset.
    - `input_data` string, required — JSON-serialized input fields.
    - `expected_output` string, nullable — Expected/gold output.
    - `predicted_output` string, nullable — Model predicted output.
    - `score` number, required — Score for this example (0.0-1.0).
  - `total` integer, required — Total evaluation results for the run.
  - `offset` integer, required — Current pagination offset.
  - `limit` integer, required — Current page size.
  - `has_more` boolean, required — Whether more results exist beyond this page.

## Other responses

- `401` — Authentication is required or the provided token is invalid.
- `404` — Run not found.
- `422` — Validation Error

## Changes

- **2026-04-18** `1f45411d7556` — 1 breaking, 1 info
  - the `items/items/id` response's property type changed from `integer` to `string` for status `200`
  - for the `path` request parameter `run_id`, the type was generalized from `integer` to `string`
- **2026-04-14** `3044e5c4a9da` — 1 info
  - endpoint added
- **2026-03-19** `78507b29ed8f` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/qredence/apis/fleet-rlm/changes/api/v1/optimization/runs/:run_id/results/get.md)

---

[API](https://skmtc.dev/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.dev/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc.dev/qredence/apis/fleet-rlm/revisions/d82643b26c96?raw)