Phone Numbers
List Phone Numbers
List phone numbers provisioned in your workspace.
GET
List Phone Numbers
Read only
Returns every phone number provisioned in your workspace, paginated. Each entry includes 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 display nickname, the inbound_agent_id currently routing incoming calls on this number, and the purchase timestamp. Use this to power a number management view, audit which numbers are in use, or sync your DialNexa number portfolio with an internal inventory.
When to use this
- Number management UIs: render a table of every number with status, type, and assigned agent.
- Routing audits: confirm every active number has an agent assigned, or surface unrouted numbers as a follow-up task.
- Cost reporting: aggregate by
country_codeortypeto attribute telephony spend per workspace, region, or use case. - Operational scripts: enumerate numbers before auditing routing assignments or provisioning additional numbers.
Query parameters
Errors
403 Forbiddenis returned when the API key cannot read phone number records.
Related endpoints
- Get Phone Number Details: fetch a single number’s detail.
- Buy a Phone Number: purchase a new number.
- Search Available Numbers: find provider numbers available for purchase.
- Link SIP Trunk: connect a bring-your-own number.
- Delete Phone Number: remove a number you no longer use.
- Pagination: how DialNexa list endpoints paginate.
List Phone Numbers