Runs
Get Outcome Run
Get one saved run of an outcome.
GET
/
v1
/
dispositions
/
{id}
/
run
/
{run_id}
Get Outcome Run
curl --request GET \
--url https://api.bland.ai/v1/dispositions/{id}/run/{run_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/dispositions/{id}/run/{run_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/v1/dispositions/{id}/run/{run_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/v1/dispositions/{id}/run/{run_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/v1/dispositions/{id}/run/{run_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/v1/dispositions/{id}/run/{run_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/dispositions/{id}/run/{run_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": "4ded1ecc-78e0-4b90-b3a3-d817615a553a",
"org_id": "abde3bdf-89e5-48e2-838a-800121f7bb9c",
"disposition_id": "9e419d19-a599-45a9-9d18-7bede9bd11aa",
"conversation_id": "58c7606b-0f77-44ea-a35d-ee6e6c93dc85",
"reference_type": "CALL",
"snippet_version": 3,
"status": "COMPLETE",
"result": {
"booked": true,
"minutes": 2.4
},
"console": {
"logs": [],
"truncated": false
},
"error": null,
"exec_time": 41,
"input": {
"call_id": "58c7606b-0f77-44ea-a35d-ee6e6c93dc85",
"call_length": 2.4
},
"created_at": "2026-10-26T15:20:03.512Z",
"finished_at": "2026-10-26T15:20:03.561Z"
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Disposition run not found"
}
]
}
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
The outcome ID.
string
required
The run ID, from List Outcome Runs.
Response
object
The run.
Show Run fields
Show Run fields
string
The run ID.
string
The organization that owns the run.
string
The outcome that ran.
string
The call or SMS conversation the outcome ran on.
string
CALL, SMS or CALL_TEST.integer | null
The script version that ran.
string
PENDING, COMPLETE or FAILED.any
What the script returned.
null until the run completes, and on a failed run.object | null
What the script logged:
logs holds the console output and truncated says whether it was cut short. null when nothing was captured.string | null
Why the run failed.
null when it succeeded.integer | null
How long the script ran, in milliseconds.
object | null
The conversation data the script received.
string
When the run started (ISO 8601).
string | null
When the run finished (ISO 8601).
null | array
null on success, otherwise an array of error objects.{
"data": {
"id": "4ded1ecc-78e0-4b90-b3a3-d817615a553a",
"org_id": "abde3bdf-89e5-48e2-838a-800121f7bb9c",
"disposition_id": "9e419d19-a599-45a9-9d18-7bede9bd11aa",
"conversation_id": "58c7606b-0f77-44ea-a35d-ee6e6c93dc85",
"reference_type": "CALL",
"snippet_version": 3,
"status": "COMPLETE",
"result": {
"booked": true,
"minutes": 2.4
},
"console": {
"logs": [],
"truncated": false
},
"error": null,
"exec_time": 41,
"input": {
"call_id": "58c7606b-0f77-44ea-a35d-ee6e6c93dc85",
"call_length": 2.4
},
"created_at": "2026-10-26T15:20:03.512Z",
"finished_at": "2026-10-26T15:20:03.561Z"
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Disposition run not found"
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
Get Outcome Run
curl --request GET \
--url https://api.bland.ai/v1/dispositions/{id}/run/{run_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/dispositions/{id}/run/{run_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/v1/dispositions/{id}/run/{run_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/v1/dispositions/{id}/run/{run_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/v1/dispositions/{id}/run/{run_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/v1/dispositions/{id}/run/{run_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/dispositions/{id}/run/{run_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": "4ded1ecc-78e0-4b90-b3a3-d817615a553a",
"org_id": "abde3bdf-89e5-48e2-838a-800121f7bb9c",
"disposition_id": "9e419d19-a599-45a9-9d18-7bede9bd11aa",
"conversation_id": "58c7606b-0f77-44ea-a35d-ee6e6c93dc85",
"reference_type": "CALL",
"snippet_version": 3,
"status": "COMPLETE",
"result": {
"booked": true,
"minutes": 2.4
},
"console": {
"logs": [],
"truncated": false
},
"error": null,
"exec_time": 41,
"input": {
"call_id": "58c7606b-0f77-44ea-a35d-ee6e6c93dc85",
"call_length": 2.4
},
"created_at": "2026-10-26T15:20:03.512Z",
"finished_at": "2026-10-26T15:20:03.561Z"
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Disposition run not found"
}
]
}