> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Test Scenarios

> List all test scenarios for your organization.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Query Parameters

**pathway\_id** `string`

Filter by pathway ID.

**persona\_id** `string`

Filter by persona ID.

**category** `string`

Filter by scenario category.

**enabled** `string`

Filter by enabled status. Pass `"true"` or `"false"`.

### Response

**scenarios** `array`

Array of scenario objects, each including assertions and the most recent run.

**scenario object**

**id** `string`

Unique identifier for the scenario.

**org\_id** `string`

Organization ID that owns this scenario.

**pathway\_id** `string`

The pathway ID being tested (null if testing a persona).

**persona\_id** `string`

The persona ID being tested (null if testing a pathway).

**name** `string`

Name of the scenario.

**description** `string`

Description of the scenario.

**category** `string`

Scenario category.

**scenario\_type** `string`

Type of scenario.

**tester\_persona\_prompt** `string`

Prompt for the simulated caller.

**tester\_persona\_name** `string`

Display name for the tester persona.

**max\_turns** `integer`

Maximum conversation turns.

**bland\_tone\_enabled** `boolean`

Whether Bland Tone scoring is enabled.

**is\_required\_for\_promotion** `boolean`

Whether this scenario is required for promotion.

**enabled** `boolean`

Whether the scenario is enabled.

**assertions** `array`

Array of assertion objects.

**most\_recent\_run** `object`

The most recent test run for this scenario (null if never run).

**created\_at** `string`

ISO 8601 timestamp of when the scenario was created.

**updated\_at** `string`

ISO 8601 timestamp of when the scenario was last updated.

```json Response theme={null}
{
  "scenarios": [
    {
      "id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
      "org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
      "pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
      "persona_id": null,
      "name": "Angry Caller Test",
      "description": "Tests de-escalation handling",
      "category": "ANGRY_CALLER",
      "scenario_type": "AGENT",
      "tester_persona_prompt": "You are a frustrated customer...",
      "tester_persona_name": "Frustrated Customer",
      "max_turns": 15,
      "bland_tone_enabled": true,
      "is_required_for_promotion": false,
      "enabled": true,
      "assertions": [
        {
          "id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
          "type": "LLM_JUDGE",
          "name": "De-escalation",
          "config": {
            "prompt": "Did the agent successfully de-escalate the situation?",
            "output_type": "score",
            "threshold": 0.7
          },
          "is_required": true,
          "weight": 1.5,
          "order": 0
        }
      ],
      "most_recent_run": {
        "id": "e5f6a7b8-9abc-def0-1234-567890abcdef",
        "status": "PASSED",
        "score": 0.85,
        "completed_at": "2026-04-13T18:30:00.000Z"
      },
      "created_at": "2026-04-10T12:00:00.000Z",
      "updated_at": "2026-04-13T18:30:00.000Z"
    },
    {
      "id": "f6a7b8c9-0abc-def1-2345-67890abcdef0",
      "org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
      "pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
      "persona_id": null,
      "name": "Happy Path - Booking",
      "description": "Tests the standard booking flow",
      "category": "HAPPY_PATH",
      "scenario_type": "AGENT",
      "tester_persona_prompt": "You want to book an appointment for next Tuesday at 2pm.",
      "tester_persona_name": "Polite Customer",
      "max_turns": 20,
      "bland_tone_enabled": false,
      "is_required_for_promotion": true,
      "enabled": true,
      "assertions": [
        {
          "id": "a7b8c9d0-1abc-ef23-4567-890abcdef012",
          "type": "NODE_REACHED",
          "name": "Reached Booking Confirmation",
          "config": {
            "node_id": "booking-confirmation-node"
          },
          "is_required": true,
          "weight": 1.0,
          "order": 0
        }
      ],
      "most_recent_run": null,
      "created_at": "2026-04-12T09:00:00.000Z",
      "updated_at": "2026-04-12T09:00:00.000Z"
    }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.