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
Query Parameters
Maximum number of agents to return. Minimum
1, maximum 500. Values outside that range are clamped. When omitted or not a number, every agent is returned. There is no offset or cursor.Response
Array of agent objects.
Show agent object
Show agent object
ID of the user who created the agent. With an API key, this is the user the key belongs to.
null when no user was recorded.The agent’s chosen identity color, read from its newest saved version. Omitted when no color has been picked.
The pathway this agent was migrated from, or
null. When one migration combined several pathways, this is the first.The persona this agent was migrated from, or
null. At most one of source_pathway_id and source_persona_id is set.{
"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?
⌘I
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
}