Skip to main content
GET
/
organization-phone-numbers
List your phone numbers
curl --request GET \
  --url https://api.dialnexa.com/v1/organization-phone-numbers \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "phn_abc123",
      "phone_number": "+912234567890",
      "label": "Main Support Line",
      "agent_id": "agt_abc123",
      "status": "active",
      "provider": "twilio",
      "created_at": "2024-03-01T10:00:00.000Z",
      "nickname": "Sales Line"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}
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

ParameterDescription
pagePage number, starting from 1.
limitResults per page (max 100, default 20).
country_codeFilter to numbers in a specific country, for example IN or US.
typeFilter to numbers of a specific type, for example local, toll_free, or mobile.

​
Errors

  • 403 Forbidden is returned when the API key cannot read phone number records.

​
Request

curl "https://api.dialnexa.com/v1/organization-phone-numbers" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "data": [
    {
      "id": "phn_f7w2kx5mb9qz",
      "phone_number": "+912234567890",
      "country_code": "IN",
      "type": "local",
      "nickname": "Mumbai Support",
      "inbound_agent_id": "agt_k7m2nq9xw4p8",
      "created_at": "2024-01-15T07:00:00.000Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1 }
}

Authorizations

​
Authorization
string
header
required

Pass your API key as a Bearer token in the Authorization header.

Query Parameters

​
page
integer
default:1
​
limit
integer
default:20

Response

200 - application/json

Success.

​
data
object[]
​
meta
object