Skip to main content
GET
Get an agent

Authorizations

Authorization
string
header
required

An org API key: Authorization: Bearer phk_…

Headers

Phonely-Organization
string | null

Optional. Must be the key's org.

Path Parameters

id
string
required

The agent's ID.

Response

Successful Response

An agent: a voice agent that answers and places the organization's calls.

id
string
required

The agent's ID.

name
string | null
required

The name shown in the web app. null when the agent has none.

object
string
default:agent
required

The type of this object, always agent.

Allowed value: "agent"
phone_number
string | null
required

The agent's primary phone number in E.164, such as +14155550100. null when it has none, or when its primary line is a SIP address.