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

> List your organization's outcomes.

Returns your outcomes, newest first. Deleted outcomes aren't included.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Query Parameters

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

The page to return, starting at 1.

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

Outcomes per page, from 1 to 100.

### Response

**data.dispositions** `array`

The outcomes on this page. Each has the same fields as [Create Outcome](https://docs.bland.ai/api-v1/post/dispositions.md) returns.

**data.pagination** `object`

**Pagination fields**

**page** `integer`

The current page.

**limit** `integer`

Outcomes per page.

**total** `integer`

Total outcomes 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": {
    "dispositions": [
      {
        "id": "e5773eb4-ddec-46c2-81b4-56ab34095d9f",
        "org_id": "3a1b45fc-b41e-47f0-9c6c-cbafc9670edf",
        "name": "appointment_outcome",
        "metadata": {},
        "snippet_id": "0f4a6ee9-c5b6-43eb-a9fb-4aa57f741372",
        "snippet_version": 3,
        "created_at": "2026-10-20T18:22:05.117Z",
        "updated_at": "2026-10-24T09:41:30.902Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "total_pages": 1
    }
  },
  "errors": null
}
```

***

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.