Phone Numbers
Get Phone Number Details
Fetch one phone number by ID.
GET
Get Phone Number Details
Read only
Returns the full record for a single purchased phone number: the E.164
Recommended. This endpoint is part of the public
/v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.phone_number, the country_code, the type (local, toll-free, or mobile), the monthly rental cost, the supported capabilities (voice, SMS where available), the display nickname, the currently assigned inbound_agent_id, and the purchase timestamp.
When to use this
- Number management UIs: render the per-number detail view in a phone-number management page.
- Routing audits: verify which agent is currently handling inbound calls on a specific number before making changes.
- Cost attribution: pull
monthly_cost_usdto attribute telephony spend per workspace or per use case in internal reports. - Compliance reviews: confirm the number’s country and capabilities match the use case it is being used for.
Path parameters
Errors
404 Not Foundis returned when the number does not exist on this workspace.403 Forbiddenis returned when the API key cannot read phone number records.
Related endpoints
- List Phone Numbers: see every number on the workspace.
- Search Available Numbers: find provider numbers available for purchase.
- Link SIP Trunk: connect a bring-your-own number.
- Buy a Phone Number: purchase a new number.
- Delete Phone Number: remove this number from the workspace.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Phone number ID
Example:
"phn_abc123"
Get Phone Number Details