> ## 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 Simulation Set

> Retrieve a simulation set with its statistics including pass rates, flakiness detection, and score distributions.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**id** `string` *required*

The simulation set ID.

### Response

**id** `string`

Unique identifier for the simulation set.

**status** `string`

Current status of the simulation set. One of `PENDING`, `RUNNING`, `PASSED`, `FAILED`, or `ERROR`.

**simulations\_per\_scenario** `integer`

Number of times each scenario is run.

**total\_scenarios** `integer`

Total number of scenarios in this set.

**statistics** `object`

Aggregated statistics for the simulation set.

**statistics object**

**per\_scenario** `object`

A map of scenario IDs to per-scenario statistics.

**per-scenario stats**

**scenario\_id** `string`

The scenario ID.

**scenario\_name** `string`

The scenario name.

**total\_runs** `integer`

Total number of simulation runs for this scenario.

**passed** `integer`

Number of runs that passed.

**failed** `integer`

Number of runs that failed.

**pass\_rate** `number`

Pass rate as a decimal between 0 and 1.

**is\_flaky** `boolean`

Whether the scenario exhibited flaky behavior (some runs passed, some failed).

**scores** `object`

Score distribution statistics including `mean`, `median`, `stddev`, `min`, and `max`.

**worst\_run\_id** `string`

The ID of the worst-performing run.

**common\_failure\_modes** `array of strings`

Most common failure reasons observed across runs.

**confidence** `string`

Statistical confidence level. One of `low`, `medium`, or `high`.

**overall** `object`

Overall aggregated statistics across all scenarios.

**overall stats**

**avg\_pass\_rate** `number`

Average pass rate across all scenarios.

**flaky\_count** `integer`

Number of scenarios detected as flaky.

**reliable\_count** `integer`

Number of scenarios that are reliably passing or failing.

**total\_runs** `integer`

Total simulation runs across all scenarios.

**created\_at** `string`

ISO 8601 timestamp of when the simulation set was created.

**completed\_at** `string`

ISO 8601 timestamp of when the simulation set completed (null if still running).

```json Response theme={null}
{
  "id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
  "status": "PASSED",
  "simulations_per_scenario": 5,
  "total_scenarios": 2,
  "statistics": {
    "per_scenario": {
      "a1b2c3d4-5678-9abc-def0-1234567890ab": {
        "scenario_id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
        "scenario_name": "Happy Path - Booking",
        "total_runs": 5,
        "passed": 5,
        "failed": 0,
        "pass_rate": 1.0,
        "is_flaky": false,
        "scores": {
          "mean": 0.92,
          "median": 0.93,
          "stddev": 0.03,
          "min": 0.87,
          "max": 0.96
        },
        "worst_run_id": "b8c9d0e1-2345-6789-abcd-ef0123456789",
        "common_failure_modes": [],
        "confidence": "high"
      },
      "f6a7b8c9-0abc-def1-2345-67890abcdef0": {
        "scenario_id": "f6a7b8c9-0abc-def1-2345-67890abcdef0",
        "scenario_name": "Angry Caller Test",
        "total_runs": 5,
        "passed": 3,
        "failed": 2,
        "pass_rate": 0.6,
        "is_flaky": true,
        "scores": {
          "mean": 0.68,
          "median": 0.71,
          "stddev": 0.15,
          "min": 0.42,
          "max": 0.85
        },
        "worst_run_id": "c9d0e1f2-3456-789a-bcde-f01234567890",
        "common_failure_modes": [
          "Agent failed to de-escalate within 3 turns",
          "Agent used dismissive language"
        ],
        "confidence": "medium"
      }
    },
    "overall": {
      "avg_pass_rate": 0.8,
      "flaky_count": 1,
      "reliable_count": 1,
      "total_runs": 10
    }
  },
  "created_at": "2026-04-14T10:00:00.000Z",
  "completed_at": "2026-04-14T10:05:32.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.