Skip to main content
GET
Get Phone Number Details
Read only
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.
Returns the full record for a single purchased phone number: the E.164 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_usd to 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.
For the entire portfolio of numbers on the workspace, use List Phone Numbers.

Path parameters

Errors

  • 404 Not Found is returned when the number does not exist on this workspace.
  • 403 Forbidden is returned when the API key cannot read phone number records.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Phone number ID

Example:

"phn_abc123"

Response

Phone number returned successfully.

id
string
Example:

"phn_abc123"

phone_number
string
Example:

"+919876543210"

provider
string
status
string