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"
}
]
}
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
string
required
Your API key for authentication.
Path Parameters
string
required
The agent’s unique identifier.
Response
object
The agent with its environments.
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.array
The agent’s three environments. Each has
id, env_type (dev, staging, or production), and current_version_id (the pinned version, or null if unpinned).null | array
null on success, or a list of error objects if the request failed.{
"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?