---
title: "List Results"
method: GET
path: "/evals/results"
tags: ["EVALS"]
---

# List Results

`GET /evals/results`

List eval results with server-side pagination.

## Query parameters

- `test_case_id` string, nullable
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- PaginatedEvalResultsResponse — Paginated response for eval results.
  - `results` EvalResultResponse[], required
    - `id` string, required
    - `test_case_id` string, nullable
    - `test_case_name` string, required
    - `test_case_description` string, nullable
    - `test_case_tags` string[], nullable
    - `status` string, nullable
    - `overall_score` number, nullable
    - `judge_errors` integer, nullable
    - `judge_model` string, nullable
    - `turn_results` TurnResult[], required
      - `turn_number` integer, required
      - `user_message` string, required
      - `expected_ai_response` string, required
      - `actual_ai_response` string, required
      - `evaluation` object, required
      - `intermediate_messages` string, nullable
    - `created_at` string, required
    - `session_id` string, nullable
    - `run_name` string, nullable
    - `tenant` string
    - `run_tenant` string, nullable
    - `trace_id` string, nullable
    - `datamate_ids_used` string[], nullable
    - `knowledge_base_ids_used` integer[], nullable
    - `tools_invoked` object, nullable
    - `knowledge_bases_queried` integer[], nullable
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required
  - `has_next` boolean, required
  - `has_prev` boolean, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-08** `103580dad816` — 2 breaking, 5 info
  - the response property `results/items/overall_score` became optional for the status `200`
  - response property `results/items/overall_score` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the optional property `results/items/judge_errors` to the response with the `200` status
  - added the optional property `results/items/judge_model` to the response with the `200` status
  - …3 more

[Change history](https://skmtc.dev/myaltimate/apis/fastapi/changes/evals/results/get.md)

---

[API](https://skmtc.dev/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.dev/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/myaltimate/fastapi/revisions/82206441f16e/schema)