---
title: "Retrieve an evaluator (scenario)"
method: GET
path: "/test_framework/v1/scenarios/{id}/"
tags: ["test_framework"]
---

# Retrieve an evaluator (scenario)

`GET /test_framework/v1/scenarios/{id}/`

Fetch a single evaluator by id. Returns full configuration including instructions, expected outcome, metrics, test profile, and — when the agent has mock tools attached and the scenario was auto-generated — the expected mock tool calls (`generated_mock_tool_entries`) with their inputs and outputs.

## Path parameters

- `id` integer, required

## Response `200`

- SchemaScenario
  - `id` integer
  - `name` string — Name of the evaluator
  - `agent` integer — Agent ID Example: `2142`
  - `project` integer, nullable
  - `assistant_id` string — Alternative to agent ID - the assistant ID to use for this scenario Example: `"asst_1234567890"`
  - `personality` integer — ID of the personality
  - `personality_name` string — Name of the personality
  - `agent_name` string — Name of the agent associated with this scenario Example: `"Customer Support Agent"`
  - `tags` string[] — List of tags of the evaluators Example: `["tag1", "tag2", "tag3"]`
  - `tool_ids` unknown
  - `metrics` integer[] — List of metric IDs Example: `[123, 456, 789]`
  - `metric_names` string[] — List of metric names Example: `["Metric 1", "Metric 2", "Metric 3"]`
  - `phone_number` string — Phone number eg: +17776666333
  - `outbound_phone_number_data` unknown
  - `first_message` string — First message of the evaluator
  - `inbound_phone_number` integer, nullable
  - `inbound_phone_number_data` unknown
  - `instructions` string — Scenario Instructions - format depends on scenario_type: - For `instruction` type: Plain text instructions - For `conditional_actions` type: JSON string with role and conditions array. Each condition has id, condition trigger (FIRST_MESSAGE, a natural-language third-person description of the main agent's observable action — e.g. `"The agent asks for your date of birth"`, matched semantically — or an integer reference to another condition's id), action (text with optional `<silence time="1.5s" />` (interruptible) or `<hold time="2s" />` (not interruptible) and `[laughter]` tags), type (standard/action_followup), and fixed_message flag
  - `conditional_actions` unknown

## Other responses

- `404`

---

[API](https://skmtc.net/cekura/apis/cekura-api.md) · [All operations](https://skmtc.net/cekura/apis/cekura-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cekura/cekura-api/revisions/d08e85615b58/schema)