List domain SMS numbers

GET

/domains/{domain}/smsnumbers

Last modified:2026-10-09 00:41:09

OperationId:GetSmsNumbersForDomain

Lists the SMS numbers in the domain in the path, with the user or call queue each one delivers messages to.

Requires Office Manager, Site Manager, Call Center Supervisor, Reseller, or Super User scope to list the whole domain. A Site Manager gets only the numbers routed to users in its own site. Basic User, Advanced User, Simple User, and Call Center Agent must filter by dest set to themselves, or by number, and then see only numbers routed to them.

With no filters, every number in the domain is returned. Filter with dest, number, number_LIKE, or site, and page with start and limit. mms-capable and group-mms-capable appear only on numbers whose carrier supports them.

To count the same numbers, use GET /domains/{domain}/smsnumbers/count. To read one number, use GET /domains/{domain}/smsnumbers/{smsnumber}. To list one user's numbers, use GET /domains/{domain}/users/{user}/smsnumbers.

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 domain's SMS numbers that you can see. A domain with none, or a filter that matches none, returns an empty array.

Bodyapplication/json

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//smsnumbers?dest=1001&number=15555550100&number_LIKE=555555&site=Main%20Office&start=undefined&limit=100' \
--header 'Authorization: Bearer <token>'

Response Example

200 - SMS numbers

[
    {
        "number": "15555550100",
        "application": "user",
        "domain": "example.com",
        "dest": "1001",
        "carrier": "bandwidth",
        "notes": "",
        "mms-capable": true,
        "group-mms-capable": true
    },
    {
        "number": "15555550101",
        "application": "callqueue",
        "domain": "example.com",
        "dest": "5000",
        "carrier": "bandwidth",
        "notes": "",
        "mms-capable": true,
        "group-mms-capable": true
    },
    {
        "number": "15555550102",
        "application": "available",
        "domain": "example.com",
        "dest": "",
        "carrier": "thinq",
        "notes": "previously used by 1003@example.com",
        "mms-capable": true
    }
]

Modified at 2026-10-09 00:41:09

Count domain SMS numbers

Create SMS number