> ## 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.

# Get Test Scenario

> Retrieve a specific test scenario with its assertions.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**id** `string` *required*

The scenario ID.

### Response

**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.

**request\_data** `object`

Custom request data.

**start\_node\_id** `string`

Starting node ID.

**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.

**input\_messages** `array`

Pre-seeded messages for replay scenarios.

**advanced\_instructions** `string`

Additional instructions for test execution.

**metadata** `object`

Arbitrary metadata.

**assertions** `array`

Array of assertion objects.

**assertion object**

**id** `string`

Unique identifier for the assertion.

**type** `string`

The assertion type.

**name** `string`

Display name for the assertion.

**config** `object`

Type-specific configuration.

**is\_required** `boolean`

Whether this assertion must pass.

**weight** `number`

Weight of this assertion in the overall score.

**order** `integer`

Evaluation order.

**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}
{
  "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 the agent's ability to de-escalate an angry caller",
  "category": "ANGRY_CALLER",
  "scenario_type": "AGENT",
  "tester_persona_prompt": "You are a frustrated customer who has been waiting on hold for 30 minutes. You are upset about a billing error on your account.",
  "tester_persona_name": "Frustrated Customer",
  "max_turns": 15,
  "request_data": null,
  "start_node_id": null,
  "bland_tone_enabled": true,
  "is_required_for_promotion": false,
  "enabled": true,
  "input_messages": null,
  "advanced_instructions": null,
  "metadata": null,
  "assertions": [
    {
      "id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
      "type": "LLM_JUDGE",
      "name": "De-escalation",
      "config": {
        "prompt": "Did the agent successfully de-escalate the situation and address the customer's concerns?",
        "output_type": "score",
        "threshold": 0.7
      },
      "is_required": true,
      "weight": 1.5,
      "order": 0
    }
  ],
  "created_at": "2026-04-10T12:00:00.000Z",
  "updated_at": "2026-04-13T18:30: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.