Skip to main content
GET
Get Agent Number Binding

Overview

Returns the agent’s inbound number binding. persona_id is null until the first successful Attach Numbers to Agent call. numbers lists the numbers attached to the agent and the environment each one answers on. An unknown agent ID returns persona_id: null rather than 404.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The agent’s unique identifier.

Response

string
The agent ID from the request path, echoed back.
string | null
ID of the persona that attached numbers route through. Bland creates it on the first attach and keeps it afterwards, so it stays set even after every number is detached. null if numbers have never been attached to this agent.
array
The numbers attached to the agent, newest first. Empty when no number is attached.
boolean
false when your account runs on dedicated infrastructure, where numbers can’t be attached to staging. Attaching to staging also requires an enterprise plan, which this field does not check.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt