Skip to main content
GET
Get all organization phone numbers (paginated)
Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. Use the /v1 version for new integrations. This endpoint remains available for existing integrations until then.
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_code or type to 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 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.

Query Parameters

sortOrder
enum<string>
Available options:
ASC,
DESC
sortBy
string
limit
number
required
page
number
required

Response

200

List of phone numbers with pagination.