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

> List test runs with optional filtering and pagination.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Query Parameters

**scenario\_id** `string`

Filter runs by scenario ID.

**pathway\_id** `string`

Filter runs by pathway ID.

**persona\_id** `string`

Filter runs by persona ID.

**batch\_id** `string`

Filter runs by batch ID.

**status** `string`

Filter runs by status. Possible values: `PENDING`, `RUNNING`, `PASSED`, `FAILED`, `ERROR`, `CANCELLED`.

**limit** `integer` (default: 50)

Maximum number of results to return. Must be between 1 and 100.

**offset** `integer` (default: 0)

Offset for pagination. Use in combination with `limit` to page through results.

### Response

**runs** `array of objects`

An array of test run objects. Each run includes scenario information and assertion results.

**total\_count** `integer`

The total number of runs matching the applied filters.

```json Response theme={null}
{
  "runs": [
    {
      "id": "a3f1b2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
      "scenario_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "pathway_id": "b1693602-c05e-4b5c-b187-d0189a42aebf",
      "persona_id": "c2d3e4f5-6a7b-8c9d-0e1f-2a3b4c5d6e7f",
      "batch_id": null,
      "status": "PASSED",
      "overall_score": 0.92,
      "turn_count": 8,
      "duration_ms": 14320,
      "created_at": "2026-04-14T10:30:00.000Z",
      "scenario": {
        "id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
        "name": "Appointment Booking - Happy Path"
      },
      "assertion_results": [
        {
          "assertion_id": "d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
          "type": "contains",
          "target": "transcript",
          "expected": "appointment confirmed",
          "passed": true
        },
        {
          "assertion_id": "e5f6a7b8-9c0d-1e2f-3a4b-5c6d7e8f9a0b",
          "type": "node_visited",
          "target": "nodes_visited",
          "expected": "confirm_booking",
          "passed": true
        }
      ]
    },
    {
      "id": "b4c2d3e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
      "scenario_id": "2b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
      "pathway_id": "b1693602-c05e-4b5c-b187-d0189a42aebf",
      "persona_id": "c2d3e4f5-6a7b-8c9d-0e1f-2a3b4c5d6e7f",
      "batch_id": null,
      "status": "FAILED",
      "overall_score": 0.45,
      "turn_count": 12,
      "duration_ms": 21050,
      "created_at": "2026-04-14T10:28:00.000Z",
      "scenario": {
        "id": "2b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
        "name": "Cancellation Flow - Angry Customer"
      },
      "assertion_results": [
        {
          "assertion_id": "f6a7b8c9-0d1e-2f3a-4b5c-6d7e8f9a0b1c",
          "type": "contains",
          "target": "transcript",
          "expected": "cancellation confirmed",
          "passed": false
        }
      ]
    }
  ],
  "total_count": 2
}
```

***

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.