Dispositions
Get Disposition Version
Retrieve one published disposition version.
GET
/
v2
/
agents
/
{agent_id}
/
dispositions
/
{disposition_id}
/
versions
/
{version_id}
Get Disposition Version
curl --request GET \
--url https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"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
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Disposition version not found"
}
]
}
Overview
Dispositions are enabled per organization. If your organization does not have access, these endpoints return
404.publishedVersionId on Get Disposition.
Headers
Path Parameters
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.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.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
The version.
Show version object
Show version object
The frozen definition, same shape as the
definition body parameter of Create Disposition. 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.{
"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
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Disposition version not found"
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
Get Disposition Version
curl --request GET \
--url https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"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
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Disposition version not found"
}
]
}