List phone numbers (short)

GET

/domains/{domain}/phonenumbers/list

Last modified:2026-10-08 23:05:36

OperationId:ListDomainPhonenumbers

Returns a short view of the domain's phone numbers: each number, its domain, its description, and its destination. Every user scope can read the numbers of its own domain. A Reseller reads the domains in its territory, and Super User and Super User Read Only read every domain.

It takes the same filters as GET /domains/{domain}/phonenumbers: dial-rule-translation-destination-user, dial-rule-translation-destination-host, enabled, dial-rule-description, dial-rule-application, dial-rule-parameter, and site. Unlike the full read, it has no default limit: without limit it returns every row. SMS-only numbers appear with only phonenumber and domain. For every field, use GET /domains/{domain}/phonenumbers.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200OK

application/json

The short rows. An empty array when none match.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠420Rate Limit Exceeded

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//phonenumbers/list?start=undefined&limit=100&dial-rule-translation-destination-user=1001&dial-rule-translation-destination-host=example.com&enabled=yes&dial-rule-description=Sales%&dial-rule-application=to-callqueue%&dial-rule-parameter=P-Charge-Info&site=Main%20Office' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Short rows

[
    {
        "phonenumber": "15555550123",
        "domain": "example.com",
        "dial-rule-description": "Main line",
        "dial-rule-translation-destination-user": "1001"
    },
    {
        "phonenumber": "15555550124",
        "domain": "example.com",
        "dial-rule-description": "Sales Queue",
        "dial-rule-translation-destination-user": "2000"
    },
    {
        "phonenumber": "15555550125",
        "domain": "example.com",
        "dial-rule-description": "Spare number",
        "dial-rule-translation-destination-user": "[*]"
    },
    {
        "phonenumber": "15555550126",
        "domain": "example.com"
    }
]

Modified at 2026-10-08 23:05:36

Read phone number

Update phone number by body