Agents
Get Agent
Retrieve an agent and its environment pointers.
GET
/
v2
/
agents
/
{agent_id}
Get Agent
curl --request GET \
--url https://api.bland.ai/v2/agents/{agent_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents/{agent_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}', 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}",
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}"
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}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents/{agent_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": "76d33db4-6e21-4505-b730-97a02e50d2ac",
"org_id": "45794f66-94ca-44a2-9248-202c5ff22717",
"name": "Front desk",
"created_by": "bd8ae00b-c51d-4364-b1b3-245ad579c44a",
"created_at": "2026-09-10T22:59:51.569Z",
"updated_at": "2026-09-10T23:14:08.220Z",
"deleted_at": null,
"environments": [
{
"id": "7a043546-b896-4680-80e4-5eb9cbde6977",
"env_type": "dev",
"current_version_id": null
},
{
"id": "ab412aa2-8827-4e12-ad45-9a964c2c8690",
"env_type": "staging",
"current_version_id": null
},
{
"id": "1595512d-ea18-4692-a40b-6c90932396b4",
"env_type": "production",
"current_version_id": "bc526394-c150-4983-bbfb-c84d1d9653f4"
}
]
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Agent not found"
}
]
}
Overview
Returns one agent with itsdev, staging, and production environments and the version each is pinned to. Use List Agents to find agent IDs.
Headers
Path Parameters
Response
The agent with its environments.
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 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.ISO 8601 timestamp of the migration that created the agent, or
null for an agent built from scratch.{
"data": {
"id": "76d33db4-6e21-4505-b730-97a02e50d2ac",
"org_id": "45794f66-94ca-44a2-9248-202c5ff22717",
"name": "Front desk",
"created_by": "bd8ae00b-c51d-4364-b1b3-245ad579c44a",
"created_at": "2026-09-10T22:59:51.569Z",
"updated_at": "2026-09-10T23:14:08.220Z",
"deleted_at": null,
"environments": [
{
"id": "7a043546-b896-4680-80e4-5eb9cbde6977",
"env_type": "dev",
"current_version_id": null
},
{
"id": "ab412aa2-8827-4e12-ad45-9a964c2c8690",
"env_type": "staging",
"current_version_id": null
},
{
"id": "1595512d-ea18-4692-a40b-6c90932396b4",
"env_type": "production",
"current_version_id": "bc526394-c150-4983-bbfb-c84d1d9653f4"
}
]
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Agent not found"
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
Get Agent
curl --request GET \
--url https://api.bland.ai/v2/agents/{agent_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents/{agent_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}', 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}",
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}"
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}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents/{agent_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": "76d33db4-6e21-4505-b730-97a02e50d2ac",
"org_id": "45794f66-94ca-44a2-9248-202c5ff22717",
"name": "Front desk",
"created_by": "bd8ae00b-c51d-4364-b1b3-245ad579c44a",
"created_at": "2026-09-10T22:59:51.569Z",
"updated_at": "2026-09-10T23:14:08.220Z",
"deleted_at": null,
"environments": [
{
"id": "7a043546-b896-4680-80e4-5eb9cbde6977",
"env_type": "dev",
"current_version_id": null
},
{
"id": "ab412aa2-8827-4e12-ad45-9a964c2c8690",
"env_type": "staging",
"current_version_id": null
},
{
"id": "1595512d-ea18-4692-a40b-6c90932396b4",
"env_type": "production",
"current_version_id": "bc526394-c150-4983-bbfb-c84d1d9653f4"
}
]
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Agent not found"
}
]
}