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

> Retrieve one published disposition version.

### Overview

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

Returns one immutable version created by [Publish Disposition](https://docs.bland.ai/api-v2/post/agents-id-dispositions-disposition-id-publish.md), including the exact definition that version executes. Find version ids with [List Disposition Versions](https://docs.bland.ai/api-v2/get/agents-id-dispositions-disposition-id-versions.md) or from `publishedVersionId` on [Get Disposition](https://docs.bland.ai/api-v2/get/agents-id-dispositions-disposition-id.md).

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

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

The agent's unique identifier. Must be a UUID; otherwise returns `400` with the message `agentId must be a valid UUID`. Returns `404 Agent not found` if the agent is not in your organization.

**disposition\_id** `string` *required*

The disposition's unique identifier. Must be a UUID; otherwise returns `400` with the message `dispositionId must be a valid UUID`. Returns `404 Disposition not found` if it does not belong to this agent.

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

The version's unique identifier. Must be a UUID; otherwise returns `400` with the message `versionId must be a valid UUID`. Returns `404 Disposition version not found` if it does not belong to this disposition.

### Response

**data** `object`

The version.

**version object**

**id** `string`

Unique identifier for the version.

**dispositionId** `string`

The disposition this version belongs to.

**versionNumber** `number`

Sequential number starting at `1`, unique per disposition.

**definition** `object`

The frozen definition, same shape as the `definition` body parameter of [Create Disposition](https://docs.bland.ai/api-v2/post/agents-id-dispositions.md). `structured_extraction` sources carry the server-written `frozen` copy of the extractor prompt, output schema, and inference configuration that this version executes; `inferenceConfig.modelProfileKey`, when present, is one of `balanced`, `fast`, or `high_accuracy`.

**publishedAt** `string`

ISO 8601 timestamp of publication.

**errors** `null | array`

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

```json Response theme={null}
{
  "data": {
    "id": "aa3f6224-34ff-49eb-a478-80cdcd57a4c6",
    "dispositionId": "8dd0d371-905b-491f-a789-f32f29db230d",
    "versionNumber": 3,
    "definition": {
      "name": "Callback request",
      "description": "Whether the caller asked to be called back, and when.",
      "timing": "immediate",
      "values": [
        {
          "id": "53974ae4-9800-4dbf-9187-bfefd9c3fb30",
          "key": "callback_time",
          "label": "Requested callback time",
          "schema": {
            "kind": "string",
            "description": "When the caller asked to be called back. Preserve exact character-by-character spelling."
          },
          "source": {
            "kind": "variable_extraction",
            "variableKey": "callback_time",
            "execution": { "reasoningEffort": "auto" }
          }
        }
      ],
      "transformation": {
        "version": 1,
        "root": {
          "kind": "object",
          "fields": {
            "callback_time": { "kind": "value", "valueId": "53974ae4-9800-4dbf-9187-bfefd9c3fb30" }
          }
        }
      },
      "postCallWebhook": { "mode": "emit_followup" }
    },
    "publishedAt": "2026-09-09T11:47:52.903Z"
  },
  "errors": null
}
```

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