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

# Fetch Evaluation Scenarios

`GET /evaluations/{evaluation_id}/evaluation_scenarios`

Fetches evaluation scenarios for a given evaluation ID.

Arguments:
    evaluation_id (str): The ID of the evaluation for which to fetch scenarios.

Raises:
    HTTPException: If the evaluation is not found or access is denied.

Returns:
    List[EvaluationScenario]: A list of evaluation scenarios.

## Path parameters

- `evaluation_id` string, required

## Response `200`

Successful Response

- OssSrcModelsApiEvaluationModelEvaluationScenario[]
  - `id` string, nullable
  - `evaluation_id` string, required
  - `inputs` EvaluationScenarioInput[], required
    - `name` string, required
    - `type` string, required
    - `value` unknown, required
  - `outputs` EvaluationScenarioOutput[], required
    - `result` Result, required
      - `type` string, required
      - `value` unknown
      - `error` Error
        - `message` string, required
        - `stacktrace` string, nullable
    - `cost` number, nullable
    - `latency` number, nullable
  - `correct_answers` CorrectAnswer[], nullable
    - `key` string, required
    - `value` string, required
  - `is_pinned` boolean, nullable
  - `note` string, nullable
  - `results` EvaluationScenarioResult[], required
    - `evaluator_config` string, required
    - `result` Result, required
      - `type` string, required
      - `value` unknown
      - `error` Error
        - `message` string, required
        - `stacktrace` string, nullable

## 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_evaluation_scenarios` removed and replaced with `fetch_legacy_evaluation_scenarios`
- **2025-06-27** `e3e84db47198` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/evaluations/:evaluation_id/evaluation_scenarios/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.dev/agenta-ai/apis/agenta-api/revisions/72fe88316d15?raw)