Phone Numbers
List Phone Numbers
deprecated
Retrieve every phone number provisioned in your workspace, including capabilities, nickname, and the assigned inbound agent.
GET
Get all organization phone numbers (paginated)
Returns every phone number provisioned in your workspace, paginated. Each entry includes the E.164
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 applying a bulk reassignment through Update Phone Number.
Query parameters
Errors
403 Forbiddenis returned when the API key cannot read phone number records.
Related endpoints
- Get Phone Number: fetch a single number’s detail.
- Buy a Phone Number: purchase a new number.
- Update Phone Number: change nickname or reassign inbound agent.
- Release a Number: release a number back to the provider’s pool.
- Pagination: how DialNexa list endpoints paginate.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Available options:
ASC, DESC Response
200
List of phone numbers with pagination.
Get all organization phone numbers (paginated)