---
title: "List evaluator scenarios"
method: GET
path: "/ai/tests/test_framework/v1/scenarios"
tags: ["AI Tests"]
---

# List evaluator scenarios

`GET /ai/tests/test_framework/v1/scenarios`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/tests/test_framework/v1/scenarios`
- Auth: HTTP bearer

Returns a paginated list of evaluator scenarios in your organization, optionally filtered by test agent or tags.

## Query parameters

- `page` integer
- `page_size` integer
- `agent_id` integer
- `assistant_id` string
- `tags` string

## Response `200`

Paginated list of evaluator scenarios.

- EvaluatorScenarioListResponse
  - `count` integer, required
  - `next` string, uri, nullable, required
  - `previous` string, uri, nullable, required
  - `results` EvaluatorScenario[], required
    - `id` integer, required
    - `name` string, required
    - `personality` integer, nullable: ID of the test personality the caller simulates.
    - `personality_name` string
    - `phone_number` string: Outbound phone number used to place the simulated call.
    - `expected_outcome_prompt` string: What a successful conversation looks like; scored by the expected-outcome metric.
    - `instructions` string: What the simulated caller should do during the conversation.
    - `scenario_language` string, nullable
    - `scenario_type` string: Type of scenario: workflow, red_teaming_voice, or red_teaming_text.
    - `tags` string[]
    - `agent` integer, nullable, required: ID of the test agent the scenario runs against.
    - `inbound_phone_number` integer, nullable
    - `inbound_phone_number_data` string, nullable
    - `metrics` integer[]: Metric IDs applied to the scenario.
    - `metric_names` string[]
    - `first_message` string: First message the simulated caller speaks or sends.
    - `tool_ids` string[]
    - `test_profile` integer, nullable
    - `test_profile_data` object, nullable
      - `id` integer
      - `project` integer, nullable
      - `agent` integer, nullable
      - `name` string
      - `information` object, nullable
    - `dynamic_variable_values` object, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `last_updated_by` integer, nullable
    - `folder_path` string, nullable

## Other responses

- `400`: Bad Request. The AI Tests service rejected the request.
- `401`: Unauthorized. Missing or invalid API key.
- `404`: Not Found. The requested resource does not exist or is not enabled for your account.
- `422`: Unprocessable Entity. A validation error occurred.
- `429`: Too Many Requests. The AI Tests service rate-limited the request.
- `503`: Service Unavailable. The AI Tests service is unavailable.

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-22** `09b2e45a88da`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/ai/tests/test_framework/v1/scenarios/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)