List Agents
curl --request GET \
--url https://api.bland.ai/v2/agents \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents"
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', 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",
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"
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")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents")
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": "c7dc8803-c265-46a7-86bc-92edf72af434",
"org_id": "45794f66-94ca-44a2-9248-202c5ff22717",
"name": "Appointment reminders",
"created_by": "bd8ae00b-c51d-4364-b1b3-245ad579c44a",
"created_at": "2026-09-09T14:12:03.101Z",
"updated_at": "2026-09-10T18:40:27.882Z",
"deleted_at": null,
"color": "teal"
},
{
"id": "01a60218-bdd1-41eb-8612-2ef3f60dd80d",
"org_id": "45794f66-94ca-44a2-9248-202c5ff22717",
"name": "Front desk",
"created_by": "6fb2ce4c-507f-45e5-9dcb-45d3139b04fd",
"created_at": "2026-09-08T09:30:44.005Z",
"updated_at": "2026-09-08T09:30:44.005Z",
"deleted_at": null
}
],
"errors": null
}
Agents
List Agents
List the agents in your organization, most recently updated first.
GET
/
v2
/
agents
List Agents
curl --request GET \
--url https://api.bland.ai/v2/agents \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents"
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', 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",
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"
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")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents")
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": "c7dc8803-c265-46a7-86bc-92edf72af434",
"org_id": "45794f66-94ca-44a2-9248-202c5ff22717",
"name": "Appointment reminders",
"created_by": "bd8ae00b-c51d-4364-b1b3-245ad579c44a",
"created_at": "2026-09-09T14:12:03.101Z",
"updated_at": "2026-09-10T18:40:27.882Z",
"deleted_at": null,
"color": "teal"
},
{
"id": "01a60218-bdd1-41eb-8612-2ef3f60dd80d",
"org_id": "45794f66-94ca-44a2-9248-202c5ff22717",
"name": "Front desk",
"created_by": "6fb2ce4c-507f-45e5-9dcb-45d3139b04fd",
"created_at": "2026-09-08T09:30:44.005Z",
"updated_at": "2026-09-08T09:30:44.005Z",
"deleted_at": null
}
],
"errors": null
}
Overview
Returns every live agent in your organization, ordered byupdated_at descending. Each entry is the agent record without its environments; call Get Agent for environment pointers.
Headers
string
required
Your API key for authentication.
Query Parameters
integer
default:"100"
Maximum number of agents to return. Minimum
1, maximum 500. Values outside that range are clamped.Response
array
Array of agent objects.
Show agent object
Show agent object
string
Unique identifier for the agent.
string
The organization that owns the agent.
string
The agent’s display name.
string | null
ID of the user who created the agent, or
null when created with an org-level key.string
ISO 8601 timestamp of creation.
string
ISO 8601 timestamp of the last update.
null
Always
null on a live agent.string
The agent’s chosen identity color, read from its newest saved version. Omitted when no color has been picked.
null | array
null on success, or a list of error objects if the request failed.{
"data": [
{
"id": "c7dc8803-c265-46a7-86bc-92edf72af434",
"org_id": "45794f66-94ca-44a2-9248-202c5ff22717",
"name": "Appointment reminders",
"created_by": "bd8ae00b-c51d-4364-b1b3-245ad579c44a",
"created_at": "2026-09-09T14:12:03.101Z",
"updated_at": "2026-09-10T18:40:27.882Z",
"deleted_at": null,
"color": "teal"
},
{
"id": "01a60218-bdd1-41eb-8612-2ef3f60dd80d",
"org_id": "45794f66-94ca-44a2-9248-202c5ff22717",
"name": "Front desk",
"created_by": "6fb2ce4c-507f-45e5-9dcb-45d3139b04fd",
"created_at": "2026-09-08T09:30:44.005Z",
"updated_at": "2026-09-08T09:30:44.005Z",
"deleted_at": null
}
],
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?