Identity
Get Agent Identity
Read the agent’s branded contact card and its delivery settings.
GET
/
v2
/
agents
/
{agent_id}
/
identity
Get Agent Identity
curl --request GET \
--url https://api.bland.ai/v2/agents/{agent_id}/identity \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents/{agent_id}/identity"
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}/identity', 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}/identity",
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}/identity"
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}/identity")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents/{agent_id}/identity")
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": "b88c3ce2-54d4-406c-bd21-733c61556151",
"org_id": "4bb834b5-8e95-487a-908d-d712a201008c",
"agent_id": "ec74c83e-5370-450b-9aa0-59757ec25a81",
"display_name": "Northwind Dental",
"tagline": "Front desk",
"support_email": "help@northwind.example",
"website": "https://northwind.example",
"address": "",
"logo_file_id": "5db9aecc-5013-4f97-8592-b0330617a6d0",
"vcf_file_id": "29be0d69-898a-41a2-b875-5aeaae7fbd23",
"vcf_delivery_enabled": false,
"rcs_enabled": true,
"bcid_enabled": false,
"bcid_status": "not_submitted",
"bcid_submission": null,
"phone_numbers": ["+18005551234"],
"logo_url": "https://files.bland.ai/agent-identity/5db9aecc-5013-4f97-8592-b0330617a6d0?signature=...",
"vcf_url": "https://files.bland.ai/agent-identity/29be0d69-898a-41a2-b875-5aeaae7fbd23?signature=...",
"created_at": "2026-09-15T05:08:35.092Z",
"updated_at": "2026-09-15T05:08:44.301Z"
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Agent not found"
}
]
}
Overview
Returns the agent’s identity: the display fields a recipient sees, the generated contact card, the numbers bound to the agent, and the delivery toggles. An agent that has never been given an identity gets one on first read, seeded with the agent’s name asdisplay_name and the remaining fields empty.
Signed URLs in the response are short lived, about an hour. Read the identity again for fresh ones rather than storing them.
Headers
Path Parameters
Response
ID of the generated contact card file. Rebuilt whenever a card field changes, so this value moves after an update.
Registration state of the verified caller display:
not_submitted, submitted, pending_review, approved, or rejected.The agent’s bound numbers in E.164, as returned by Get Agent Inbound Numbers. Empty when no number is attached.
{
"data": {
"id": "b88c3ce2-54d4-406c-bd21-733c61556151",
"org_id": "4bb834b5-8e95-487a-908d-d712a201008c",
"agent_id": "ec74c83e-5370-450b-9aa0-59757ec25a81",
"display_name": "Northwind Dental",
"tagline": "Front desk",
"support_email": "help@northwind.example",
"website": "https://northwind.example",
"address": "",
"logo_file_id": "5db9aecc-5013-4f97-8592-b0330617a6d0",
"vcf_file_id": "29be0d69-898a-41a2-b875-5aeaae7fbd23",
"vcf_delivery_enabled": false,
"rcs_enabled": true,
"bcid_enabled": false,
"bcid_status": "not_submitted",
"bcid_submission": null,
"phone_numbers": ["+18005551234"],
"logo_url": "https://files.bland.ai/agent-identity/5db9aecc-5013-4f97-8592-b0330617a6d0?signature=...",
"vcf_url": "https://files.bland.ai/agent-identity/29be0d69-898a-41a2-b875-5aeaae7fbd23?signature=...",
"created_at": "2026-09-15T05:08:35.092Z",
"updated_at": "2026-09-15T05:08:44.301Z"
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Agent not found"
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
Get Agent Identity
curl --request GET \
--url https://api.bland.ai/v2/agents/{agent_id}/identity \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/agents/{agent_id}/identity"
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}/identity', 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}/identity",
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}/identity"
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}/identity")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/agents/{agent_id}/identity")
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": "b88c3ce2-54d4-406c-bd21-733c61556151",
"org_id": "4bb834b5-8e95-487a-908d-d712a201008c",
"agent_id": "ec74c83e-5370-450b-9aa0-59757ec25a81",
"display_name": "Northwind Dental",
"tagline": "Front desk",
"support_email": "help@northwind.example",
"website": "https://northwind.example",
"address": "",
"logo_file_id": "5db9aecc-5013-4f97-8592-b0330617a6d0",
"vcf_file_id": "29be0d69-898a-41a2-b875-5aeaae7fbd23",
"vcf_delivery_enabled": false,
"rcs_enabled": true,
"bcid_enabled": false,
"bcid_status": "not_submitted",
"bcid_submission": null,
"phone_numbers": ["+18005551234"],
"logo_url": "https://files.bland.ai/agent-identity/5db9aecc-5013-4f97-8592-b0330617a6d0?signature=...",
"vcf_url": "https://files.bland.ai/agent-identity/29be0d69-898a-41a2-b875-5aeaae7fbd23?signature=...",
"created_at": "2026-09-15T05:08:35.092Z",
"updated_at": "2026-09-15T05:08:44.301Z"
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Agent not found"
}
]
}