---
title: "Fetch Evaluation"
method: GET
path: "/evaluations/{evaluation_id}"
tags: ["Evaluations"]
---

# Fetch Evaluation

`GET /evaluations/{evaluation_id}`

Fetches a single evaluation based on its ID.

Args:
    evaluation_id (str): The ID of the evaluation to fetch.

Returns:
    Evaluation: The fetched evaluation.

## Path parameters

- `evaluation_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

- **2025-06-27** `e3e84db47198` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/evaluations/:evaluation_id/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/e3e84db47198/schema)