List phone numbers

GET

/domains/{domain}/phonenumbers

Last modified:2026-10-08 23:04:35

OperationId:GetDomainPhonenumbers

Returns the phone numbers assigned to a domain, with where calls to each one go and its SMS assignment, if any. 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.

Numbers that exist only as an SMS assignment, with no dial rule, follow the dial-rule rows with sms-only set to true. start and limit page across both sets, 100 rows at a time unless you set limit. For the total, call GET /domains/{domain}/phonenumbers/count with the same filters.

Each domain keeps its numbers in the dial plan its inventory.did-table setting names, DID Table unless the domain changes it. Numbers that are not assigned to any domain are not listed here.

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 numbers assigned to the domain. 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?start=undefined&limit=undefined&dial-rule-translation-destination-user=1001&dial-rule-translation-destination-host=example.com&enabled=yes&dial-rule-description=Sales%&site=Main%20Office&dial-rule-application=to-callqueue%&dial-rule-parameter=P-Charge-Info' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Numbers in a domain

[
    {
        "phonenumber": "15555550123",
        "domain": "example.com",
        "dial-rule-description": "Main line",
        "enabled": "yes",
        "dial-rule-application": "to-user",
        "dial-rule-parameter": "",
        "dial-rule-translation-destination-user": "1001",
        "dial-rule-translation-destination-host": "example.com",
        "dial-rule-translation-source-name": "[*]",
        "sms-enabled": true,
        "sms-application": "user",
        "sms-carrier": "bandwidth",
        "sms-dest": "1001",
        "mms-capable": true,
        "group-mms-capable": true
    },
    {
        "phonenumber": "15555550124",
        "domain": "example.com",
        "dial-rule-description": "Sales Queue",
        "enabled": "yes",
        "dial-rule-application": "to-callqueue",
        "dial-rule-parameter": "",
        "dial-rule-translation-destination-user": "2000",
        "dial-rule-translation-destination-host": "example.com",
        "dial-rule-translation-source-name": "[*]"
    },
    {
        "phonenumber": "15555550125",
        "domain": "example.com",
        "dial-rule-description": "Spare number",
        "enabled": "yes",
        "dial-rule-application": "available-number",
        "dial-rule-parameter": "",
        "dial-rule-translation-destination-user": "[*]",
        "dial-rule-translation-destination-host": "[*]",
        "dial-rule-translation-source-name": "[*]"
    },
    {
        "phonenumber": "15555550126",
        "domain": "example.com",
        "sms-only": true,
        "sms-enabled": true,
        "sms-application": "callqueue",
        "sms-carrier": "bandwidth",
        "sms-dest": "2000",
        "mms-capable": true,
        "group-mms-capable": true
    }
]

Modified at 2026-10-08 23:04:35

destination-application mappings and parameter parsing

Create phone number