Get Judge Version
curl --request GET \
--url https://api.bland.ai/v2/agents/{agent_id}/dispositions/judges/{judge_id}/versions/{version_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents/{agent_id}/dispositions/judges/{judge_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/judges/{judge_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/judges/{judge_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/judges/{judge_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/judges/{judge_id}/versions/{version_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents/{agent_id}/dispositions/judges/{judge_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": "4420749d-ff1a-4edd-ad8a-4b61f2ae963a",
"judgeId": "cfd538c3-507f-4976-90f4-db92369ee48b",
"versionNumber": 2,
"name": "Caller sentiment",
"description": "How the caller felt by the end of the conversation.",
"modality": "text",
"systemPromptMd": "You review customer service transcripts and classify the caller's closing sentiment.",
"promptMd": "Read the full transcript. Pick the level that best describes how the caller felt in the final third of the call.",
"levels": [
{
"key": "positive",
"label": "Positive",
"promptMd": "The caller thanks the agent, confirms the issue is resolved, or sounds pleased.",
"target": true
},
{
"key": "neutral",
"label": "Neutral",
"promptMd": "The caller is matter-of-fact with no clear positive or negative signal.",
"target": true
},
{
"key": "negative",
"label": "Negative",
"promptMd": "The caller expresses frustration, threatens to cancel, or hangs up mid-sentence.",
"target": false
}
]
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Judge version not found"
}
]
}
Catalogs
Get Judge Version
Retrieve one version of a judge’s rubric.
GET
/
v2
/
agents
/
{agent_id}
/
dispositions
/
judges
/
{judge_id}
/
versions
/
{version_id}
Get Judge Version
curl --request GET \
--url https://api.bland.ai/v2/agents/{agent_id}/dispositions/judges/{judge_id}/versions/{version_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents/{agent_id}/dispositions/judges/{judge_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/judges/{judge_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/judges/{judge_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/judges/{judge_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/judges/{judge_id}/versions/{version_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents/{agent_id}/dispositions/judges/{judge_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": "4420749d-ff1a-4edd-ad8a-4b61f2ae963a",
"judgeId": "cfd538c3-507f-4976-90f4-db92369ee48b",
"versionNumber": 2,
"name": "Caller sentiment",
"description": "How the caller felt by the end of the conversation.",
"modality": "text",
"systemPromptMd": "You review customer service transcripts and classify the caller's closing sentiment.",
"promptMd": "Read the full transcript. Pick the level that best describes how the caller felt in the final third of the call.",
"levels": [
{
"key": "positive",
"label": "Positive",
"promptMd": "The caller thanks the agent, confirms the issue is resolved, or sounds pleased.",
"target": true
},
{
"key": "neutral",
"label": "Neutral",
"promptMd": "The caller is matter-of-fact with no clear positive or negative signal.",
"target": true
},
{
"key": "negative",
"label": "Negative",
"promptMd": "The caller expresses frustration, threatens to cancel, or hangs up mid-sentence.",
"target": false
}
]
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Judge version not found"
}
]
}
Overview
Dispositions are enabled per organization. If your organization does not have access, these endpoints return
404.judgeVersionId listed by Get Judge Catalog.
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
The agent’s unique identifier. A malformed id returns
400 with the message agentId must be a valid UUID.string
required
The judge’s unique identifier. Must be organization-wide or scoped to this agent; otherwise returns
404 with the message Judge not found. A malformed id returns 400 with the message judgeId must be a valid UUID.string
required
The version’s unique identifier. Must belong to
judge_id; otherwise returns 404 with the message Judge version not found. A malformed id returns 400 with the message versionId must be a valid UUID.Response
object
The judge version.
Show judge version object
Show judge version object
string
Unique identifier for the version.
string
The judge this version belongs to.
integer
Sequential version number within the judge.
string
Display name at this version.
string | null
Description at this version.
string
text when the judge reads the transcript, audio when it listens to the call recording.string
The rubric’s system prompt in Markdown. May be empty.
string
The rubric’s task prompt in Markdown. May be empty on an unpublished draft.
array
The outcome levels the judge chooses from, in rubric order. Each has
key (the level’s stable key), label (display name), promptMd (the criteria for selecting this level), and target (true when this level counts as a passing outcome).null | array
null on success, or a list of error objects if the request failed.{
"data": {
"id": "4420749d-ff1a-4edd-ad8a-4b61f2ae963a",
"judgeId": "cfd538c3-507f-4976-90f4-db92369ee48b",
"versionNumber": 2,
"name": "Caller sentiment",
"description": "How the caller felt by the end of the conversation.",
"modality": "text",
"systemPromptMd": "You review customer service transcripts and classify the caller's closing sentiment.",
"promptMd": "Read the full transcript. Pick the level that best describes how the caller felt in the final third of the call.",
"levels": [
{
"key": "positive",
"label": "Positive",
"promptMd": "The caller thanks the agent, confirms the issue is resolved, or sounds pleased.",
"target": true
},
{
"key": "neutral",
"label": "Neutral",
"promptMd": "The caller is matter-of-fact with no clear positive or negative signal.",
"target": true
},
{
"key": "negative",
"label": "Negative",
"promptMd": "The caller expresses frustration, threatens to cancel, or hangs up mid-sentence.",
"target": false
}
]
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Judge version not found"
}
]
}
Docs for agents: llms.txt
Was this page helpful?