List Check Runs
curl --request GET \
--url https://api.bland.ai/v2/agents/{agent_id}/check-runs \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents/{agent_id}/check-runs"
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}/check-runs', 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}/check-runs",
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}/check-runs"
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}/check-runs")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents/{agent_id}/check-runs")
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": "ac5df482-7883-412b-b8a8-bb6496d500ec",
"agent_id": "35675d2f-3e9d-4d61-a43c-4cf4db5bddc9",
"env_type": "staging",
"agent_version_id": "dacfbe0a-bc77-4d0c-9c27-b969ed928dcd",
"semver": null,
"version_name": "Add callback offer",
"status": "RUNNING",
"judge_names": ["Resolution quality"],
"scenario_count": 2,
"simulations_count": 5,
"overall_passed": null,
"verdicts": null,
"simulation_set_id": "c4f2e783-688c-41b0-ae2f-b77773805771",
"eval_run_id": null,
"error_message": null,
"triggered_by": "4bf4c1d6-b1f0-4a29-809f-3fcee3709a07",
"created_at": "2026-09-10T18:41:02.774Z",
"started_at": "2026-09-10T18:41:05.309Z",
"completed_at": null
},
{
"id": "f0024822-5696-4392-929b-88a88a966e71",
"agent_id": "35675d2f-3e9d-4d61-a43c-4cf4db5bddc9",
"env_type": "staging",
"agent_version_id": "6b2027df-5727-4feb-8215-2d57a1cfe82b",
"semver": "1.3.0",
"version_name": null,
"status": "PASSED",
"judge_names": ["Resolution quality"],
"scenario_count": 2,
"simulations_count": 5,
"overall_passed": true,
"verdicts": [
{
"eval_agent_id": "bcb07d72-36f0-49db-8fdf-f922d7b0a736",
"eval_agent_version_id": "0754e124-3915-4666-bd22-aa7f5f6d06cb",
"name": "Resolution quality",
"required": true,
"target_level_keys": ["good", "excellent"],
"match_rate": 0.9,
"score": 84.6,
"passed": true
}
],
"simulation_set_id": "698e65a5-dd49-448f-8db9-6c5e7e667bec",
"eval_run_id": "b1aa992f-3503-42b0-b3f5-6c376d037090",
"error_message": null,
"triggered_by": null,
"created_at": "2026-09-09T11:15:48.020Z",
"started_at": "2026-09-09T11:15:50.611Z",
"completed_at": "2026-09-09T11:27:13.488Z"
}
],
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Agent not found"
}
]
}
Checks
List Check Runs
List an agent’s check runs for one environment.
GET
/
v2
/
agents
/
{agent_id}
/
check-runs
List Check Runs
curl --request GET \
--url https://api.bland.ai/v2/agents/{agent_id}/check-runs \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents/{agent_id}/check-runs"
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}/check-runs', 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}/check-runs",
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}/check-runs"
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}/check-runs")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents/{agent_id}/check-runs")
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": "ac5df482-7883-412b-b8a8-bb6496d500ec",
"agent_id": "35675d2f-3e9d-4d61-a43c-4cf4db5bddc9",
"env_type": "staging",
"agent_version_id": "dacfbe0a-bc77-4d0c-9c27-b969ed928dcd",
"semver": null,
"version_name": "Add callback offer",
"status": "RUNNING",
"judge_names": ["Resolution quality"],
"scenario_count": 2,
"simulations_count": 5,
"overall_passed": null,
"verdicts": null,
"simulation_set_id": "c4f2e783-688c-41b0-ae2f-b77773805771",
"eval_run_id": null,
"error_message": null,
"triggered_by": "4bf4c1d6-b1f0-4a29-809f-3fcee3709a07",
"created_at": "2026-09-10T18:41:02.774Z",
"started_at": "2026-09-10T18:41:05.309Z",
"completed_at": null
},
{
"id": "f0024822-5696-4392-929b-88a88a966e71",
"agent_id": "35675d2f-3e9d-4d61-a43c-4cf4db5bddc9",
"env_type": "staging",
"agent_version_id": "6b2027df-5727-4feb-8215-2d57a1cfe82b",
"semver": "1.3.0",
"version_name": null,
"status": "PASSED",
"judge_names": ["Resolution quality"],
"scenario_count": 2,
"simulations_count": 5,
"overall_passed": true,
"verdicts": [
{
"eval_agent_id": "bcb07d72-36f0-49db-8fdf-f922d7b0a736",
"eval_agent_version_id": "0754e124-3915-4666-bd22-aa7f5f6d06cb",
"name": "Resolution quality",
"required": true,
"target_level_keys": ["good", "excellent"],
"match_rate": 0.9,
"score": 84.6,
"passed": true
}
],
"simulation_set_id": "698e65a5-dd49-448f-8db9-6c5e7e667bec",
"eval_run_id": "b1aa992f-3503-42b0-b3f5-6c376d037090",
"error_message": null,
"triggered_by": null,
"created_at": "2026-09-09T11:15:48.020Z",
"started_at": "2026-09-09T11:15:50.611Z",
"completed_at": "2026-09-09T11:27:13.488Z"
}
],
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Agent not found"
}
]
}
Overview
Returns the agent’s check runs for one environment, newest first, including runs still in flight. Use it for history or to see which run is active. To poll a single run, use Get Check Run.Headers
string
required
Your API key for authentication.
Path Parameters
string
required
The agent’s unique identifier.
Query Parameters
string
default:"production"
The environment to list runs for:
staging or production. Any other value falls back to production.integer
default:"25"
Maximum number of runs to return. Minimum
1, maximum 100. Values outside that range are clamped.Response
array
Array of check run objects, newest first.
Show check run object
Show check run object
string
Unique identifier for the check run.
string
The agent the run belongs to.
string
The environment whose checks were run:
staging or production.string
The candidate version the run scored.
string | null
The candidate’s published version number, or
null if it has never been published.string | null
The candidate’s saved name, or
null if it has none.string
PENDING, RUNNING, PASSED, FAILED, ERROR, or CANCELLED. The last four are terminal.array
Display names of the judges frozen into the run when it started.
integer
Number of scenarios the run drove conversations from.
integer
Conversations generated per scenario.
boolean | null
true when the run PASSED, false when it FAILED, null otherwise.array | null
Per-judge results, or
null until the run completes. Each has eval_agent_id, eval_agent_version_id, name, required, target_level_keys, match_rate, score, and passed. See Get Check Run for field details.string | null
ID of the generated conversation set.
null until generation starts.string | null
ID of the scoring run.
null until scoring starts.string | null
Why the run ended in
ERROR, or null.string | null
ID of the user who started the run, or
null when started with an org-level key.string
ISO 8601 timestamp the run was created.
string | null
When scoring began.
null while PENDING.string | null
When the run reached a terminal status.
null while in flight.null | array
null on success, or a list of error objects if the request failed.{
"data": [
{
"id": "ac5df482-7883-412b-b8a8-bb6496d500ec",
"agent_id": "35675d2f-3e9d-4d61-a43c-4cf4db5bddc9",
"env_type": "staging",
"agent_version_id": "dacfbe0a-bc77-4d0c-9c27-b969ed928dcd",
"semver": null,
"version_name": "Add callback offer",
"status": "RUNNING",
"judge_names": ["Resolution quality"],
"scenario_count": 2,
"simulations_count": 5,
"overall_passed": null,
"verdicts": null,
"simulation_set_id": "c4f2e783-688c-41b0-ae2f-b77773805771",
"eval_run_id": null,
"error_message": null,
"triggered_by": "4bf4c1d6-b1f0-4a29-809f-3fcee3709a07",
"created_at": "2026-09-10T18:41:02.774Z",
"started_at": "2026-09-10T18:41:05.309Z",
"completed_at": null
},
{
"id": "f0024822-5696-4392-929b-88a88a966e71",
"agent_id": "35675d2f-3e9d-4d61-a43c-4cf4db5bddc9",
"env_type": "staging",
"agent_version_id": "6b2027df-5727-4feb-8215-2d57a1cfe82b",
"semver": "1.3.0",
"version_name": null,
"status": "PASSED",
"judge_names": ["Resolution quality"],
"scenario_count": 2,
"simulations_count": 5,
"overall_passed": true,
"verdicts": [
{
"eval_agent_id": "bcb07d72-36f0-49db-8fdf-f922d7b0a736",
"eval_agent_version_id": "0754e124-3915-4666-bd22-aa7f5f6d06cb",
"name": "Resolution quality",
"required": true,
"target_level_keys": ["good", "excellent"],
"match_rate": 0.9,
"score": 84.6,
"passed": true
}
],
"simulation_set_id": "698e65a5-dd49-448f-8db9-6c5e7e667bec",
"eval_run_id": "b1aa992f-3503-42b0-b3f5-6c376d037090",
"error_message": null,
"triggered_by": null,
"created_at": "2026-09-09T11:15:48.020Z",
"started_at": "2026-09-09T11:15:50.611Z",
"completed_at": "2026-09-09T11:27:13.488Z"
}
],
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Agent not found"
}
]
}
Docs for agents: llms.txt
Was this page helpful?