Platform APIPhone Numbers

Get a phone number

Retrieves detailed information about a specific phone number.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

phone_number_slugstringRequired

The phone number slug (phone number without the leading +).

Query parameters

workspacestringRequired
Workspace ID.

Response

200
slugstring or null

The phone number slug (phone number without the leading +).

address_requirementstring or null
Address requirement for the phone number.
phone_numberstring or null
The full phone number in E.164 format.
friendly_namestring or null

A human-readable name for the phone number.

is_sms_capableboolean or null
Whether the phone number can send and receive SMS.
is_voice_capableboolean or null
Whether the phone number can make and receive voice calls.
iso_countrystring or null
ISO country code for the phone number.
localitystring or null
The locality or city associated with the phone number.
sip_auth_usernamestring or null
SIP authentication username, if configured.
sip_outbound_proxystring or null
SIP outbound proxy, if configured.
sip_term_uristring or null
SIP termination URI.
sidstring or null
Phone number SID from the provider.
provider_namestring or null
Name of the telephony provider.
regionstring or null
The region associated with the phone number.
agency_workspace_idstring or null
Agency workspace ID, if applicable.
workspace_idstring or null
The workspace ID the phone number belongs to.
created_atdatetime or null
Timestamp when the phone number was created.
updated_atdatetime or null
Timestamp when the phone number was last updated.
assistantslist of strings or null
List of assistant IDs attached to this phone number.

Errors