List Check Runs

GET

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>'

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))

}

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

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. With an API key, this is the user the key belongs to. null when no user was recorded.

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

⌘I

List Check Runs

curl --request GET \
  --url https://api.bland.ai/v2/agents/{agent_id}/check-runs \
  --header 'authorization: <authorization>'

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))

}

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"
    }
  ]
}