> ## 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 Disposition Extractor Version

> Retrieve one version of an extractor.

### Overview

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

Returns a single extractor version by id, whether it is the `editable` draft or an `archived` published version. Published versions are immutable, so this is the exact prompt and schema a disposition runs when it pins that version. Version ids come from `currentVersionId` and `activeVersionId` on [Get Disposition Extractor](https://docs.bland.ai/api-v2/get/agents-id-dispositions-extractors-extractor-id.md) and from `extractorVersionId` on [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`.

**extractor\_id** `string` *required*

The extractor's unique identifier. Must be organization-wide or scoped to this agent; otherwise returns `404` with the message `Disposition extractor not found`. A malformed id returns `400` with the message `extractorId must be a valid UUID`.

**version\_id** `string` *required*

The version's unique identifier. Must belong to `extractor_id`; otherwise returns `404` with the message `Disposition extractor version not found`. A malformed id returns `400` with the message `versionId must be a valid UUID`.

### Response

**data** `object`

The extractor version.

**version object**

**id** `string`

Unique identifier for the version.

**extractorId** `string`

The extractor this version belongs to.

**versionNumber** `integer`

Starts at `1` and increments on each publish.

**state** `string`

`editable` for the live draft, `archived` for a published version.

**name** `string`

Display name at this version.

**description** `string | null`

Description at this version.

**systemPromptMd** `string`

The system prompt. Empty string when none was set.

**promptMd** `string`

The extraction prompt.

**outputSchema** `object`

The value schema the extractor produces: a `kind` of `boolean`, `string`, `number`, `enum`, `array`, or `object` plus kind-specific fields. See [Create Disposition Extractor](https://docs.bland.ai/api-v2/post/agents-id-dispositions-extractors.md) for the full shape.

**inferenceConfig** `object`

`modelProfileKey` (a `key` from [Get Model Profile Catalog](https://docs.bland.ai/api-v2/get/agents-id-dispositions-model-profile-catalog.md)), `contextSources` (the evidence the extractor reads), and, when set, `temperature`, `maxOutputTokens`, and `thinking`.

**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": "5d807088-411f-42b4-8193-a66f1949cd90",
    "extractorId": "4edf5644-178b-4d7d-a434-a1b61beb3127",
    "versionNumber": 1,
    "state": "archived",
    "name": "Callback window",
    "description": "When the caller asked to be called back.",
    "systemPromptMd": "You extract scheduling details from customer service calls.",
    "promptMd": "Find the day and time window the caller asked for a callback. Leave fields empty if the caller did not ask for one.",
    "outputSchema": {
      "kind": "object",
      "properties": {
        "requested": { "kind": "boolean", "description": "Whether the caller asked for a callback." },
        "window_start": { "kind": "string", "format": "date-time" },
        "window_end": { "kind": "string", "format": "date-time" }
      },
      "required": ["requested"]
    },
    "inferenceConfig": {
      "modelProfileKey": "high_accuracy",
      "temperature": 0,
      "maxOutputTokens": 600,
      "thinking": "medium",
      "contextSources": ["transcript"]
    },
    "createdAt": "2026-09-03T09:12:50.004Z",
    "updatedAt": "2026-09-05T14:30:22.671Z"
  },
  "errors": null
}
```

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