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"
}
]
}
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
string
required
Your API key for authentication.
Path Parameters
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.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.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
object
The version.
Show version object
Show version object
string
Unique identifier for the version.
string
The disposition this version belongs to.
number
Sequential number starting at
1, unique per disposition.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.string
ISO 8601 timestamp of publication.
null | array
null on success, or a list of error objects if the request failed.{
"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?