Skip to main content
GET
/
v1
/
agents
/
{agentId}
/
telephony
/
phone-numbers
/
{phoneNumber}
Get a specific phone number
curl --request GET \
  --url https://api.us.poly.ai/v1/agents/{agentId}/telephony/phone-numbers/{phoneNumber} \
  --header 'x-api-key: <api-key>'
{
  "number": "<string>",
  "projectId": "<string>",
  "accountId": "<string>",
  "clientEnv": "<string>",
  "connectorId": "<string>"
}

Authorizations

x-api-key
string
header
required

Path Parameters

agentId
string
required
phoneNumber
string
required

Response

Successful response

A phone number owned by the project, plus the connector it routes incoming calls to.

number
string
required

Phone number in E.164 format

projectId
string
required

Project this number belongs to

accountId
string
required

Account this number belongs to

clientEnv
string
required

Client environment (sandbox, pre-release, live)

connectorId
string

Connector this number is routed to

Last modified on April 22, 2026