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

> List the saved runs of an outcome.

Returns the outcome's runs, newest first.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**id** `string` *required*

The outcome ID.

### Query Parameters

**page** `integer` (default: 1)

The page to return, starting at 1.

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

Runs per page, from 1 to 100.

### Response

**data.runs** `array`

The runs on this page. Each has the same fields as [Get Outcome Run](https://docs.bland.ai/api-v1/get/dispositions-id-run-run-id.md) returns.

**data.pagination** `object`

**Pagination fields**

**page** `integer`

The current page.

**limit** `integer`

Runs per page.

**total** `integer`

Total runs across all pages.

**total\_pages** `integer`

Total number of pages.

**errors** `null | array`

`null` on success, otherwise an array of error objects.

```json Response theme={null}
{
  "data": {
    "runs": [
      {
        "id": "80a9cfa5-8af1-46a3-ae4d-64dffb08daf5",
        "org_id": "9bce53cb-ce8d-4fd1-a2ba-6333ffbcc13e",
        "disposition_id": "66505ae6-3416-4f0d-af53-bdd322a0aecb",
        "conversation_id": "fbd83eea-fff1-44a2-b520-9c21e70bdc8d",
        "reference_type": "CALL",
        "snippet_version": 3,
        "status": "COMPLETE",
        "result": {
          "booked": true,
          "minutes": 2.4
        },
        "console": {
          "logs": [],
          "truncated": false
        },
        "error": null,
        "exec_time": 41,
        "input": {
          "call_id": "fbd83eea-fff1-44a2-b520-9c21e70bdc8d",
          "call_length": 2.4
        },
        "created_at": "2026-10-26T15:20:03.512Z",
        "finished_at": "2026-10-26T15:20:03.561Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "total_pages": 1
    }
  },
  "errors": null
}
```

```json Not Found theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "NOT_FOUND",
      "message": "Disposition not found"
    }
  ]
}
```

***

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.