---
title: "Fetch List Evaluations"
method: GET
path: "/evaluations"
tags: ["Evaluations"]
---

# Fetch List Evaluations

`GET /evaluations`

Fetches a list of evaluations, optionally filtered by an app ID.

Args:
    app_id (Optional[str]): An optional app ID to filter the evaluations.

Returns:
    List[Evaluation]: A list of evaluations.

## Query parameters

- `app_id` string, required

## Response `200`

Successful Response

- Evaluation[]
  - `id` string, required
  - `app_id` string, required
  - `project_id` string, required
  - `variant_ids` string[], required
  - `variant_names` string[], required
  - `variant_revision_ids` string[], required
  - `revisions` string[], required
  - `testset_id` string, nullable
  - `testset_name` string, nullable
  - `status` Result, required
    - `type` string, required
    - `value` unknown
    - `error` Error
      - `message` string, required
      - `stacktrace` string, nullable
  - `aggregated_results` AggregatedResult[], required
    - `evaluator_config` union, required
      - EvaluatorConfig
        - `id` string, required
        - `name` string, required
        - `project_id` string, required
        - `evaluator_key` string, required
        - `settings_values` object, nullable
        - `created_at` string, required
        - `updated_at` string, required
      - object
    - `result` Result, required
      - `type` string, required
      - `value` unknown
      - `error` Error
        - `message` string, required
        - `stacktrace` string, nullable
  - `average_cost` Result
    - `type` string, required
    - `value` unknown
    - `error` Error
      - `message` string, required
      - `stacktrace` string, nullable
  - `total_cost` Result
    - `type` string, required
    - `value` unknown
    - `error` Error
      - `message` string, required
      - `stacktrace` string, nullable
  - `average_latency` Result
    - `type` string, required
    - `value` unknown
    - `error` Error
      - `message` string, required
      - `stacktrace` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-02-13** `72fe88316d15` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2025-11-05** `e62506c24377` — 1 info
  - api operation id `fetch_list_evaluations_evaluations_get` removed and replaced with `fetch_legacy_evaluations`
- **2025-06-27** `e3e84db47198` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/evaluations/get.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agenta-ai/agenta-api/revisions/72fe88316d15/schema)