> ## 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 Disposition Extractors

> List the extractors available to an agent's dispositions.

### Overview

> [!NOTE]
>
> Dispositions are enabled per organization. If your organization does not have access, these endpoints return `404`.

Returns every extractor this agent can use, published or not: organization-wide extractors plus extractors scoped to this agent, most recently updated first. Each entry is the extractor record without its version bodies; call [Get Disposition Extractor](https://docs.bland.ai/api-v2/get/agents-id-dispositions-extractors-extractor-id.md) for those. For only the published extractors a disposition can pin, use [Get Extractor Catalog](https://docs.bland.ai/api-v2/get/agents-id-dispositions-extractor-catalog.md).

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**agent\_id** `string` *required*

The agent's unique identifier. A malformed id returns `400` with the message `agentId must be a valid UUID`.

### Response

**data** `array`

Array of extractor objects.

**extractor object**

**id** `string`

Unique identifier for the extractor.

**agentId** `string | null`

`null` for an organization-wide extractor available to every agent. Otherwise the id of the one agent it is scoped to.

**key** `string`

Stable machine key, unique within your organization.

**name** `string`

The extractor's display name.

**description** `string | null`

Optional description.

**currentVersionId** `string`

The `editable` draft version. Pass it as `expectedVersionId` when updating or publishing.

**activeVersionId** `string | null`

The most recently published version, or `null` if the extractor has never been published. Only published extractors appear in the extractor catalog.

**draftRevision** `integer`

Concurrency counter. Starts at `1` and increments on every draft update and publish. Pass it as `expectedDraftRevision` when updating or publishing.

**createdAt** `string`

ISO 8601 timestamp of creation.

**updatedAt** `string`

ISO 8601 timestamp of the last update.

**errors** `null | array`

`null` on success, or a list of error objects if the request failed.

```json Response theme={null}
{
  "data": [
    {
      "id": "a3d48658-9827-4726-8560-1da7c46402ed",
      "agentId": null,
      "key": "appointment_outcome",
      "name": "Appointment outcome",
      "description": "Whether an appointment was booked, rescheduled, or declined.",
      "currentVersionId": "1164a759-ad0c-4e44-aeb9-f7b1e3ea1704",
      "activeVersionId": "7146de47-7558-47b9-b690-82fca5ef50a9",
      "draftRevision": 3,
      "createdAt": "2026-09-01T15:02:11.480Z",
      "updatedAt": "2026-09-09T18:44:03.117Z"
    },
    {
      "id": "dca50693-63e3-4ffd-a7c1-8511df6aa6f2",
      "agentId": "eaf4ec8e-74d9-4bbc-a5e6-7cf10e4ff151",
      "key": "callback_window",
      "name": "Callback window",
      "description": null,
      "currentVersionId": "cde3f9e9-8448-4e1a-ad26-6f3f245f8d00",
      "activeVersionId": null,
      "draftRevision": 1,
      "createdAt": "2026-09-08T10:21:37.902Z",
      "updatedAt": "2026-09-08T10:21:37.902Z"
    }
  ],
  "errors": null
}
```

```json Not Found theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "NOT_FOUND",
      "message": "Agent 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.