Read SMS number

GET

/domains/{domain}/smsnumbers/{smsnumber}

Last modified:2026-10-03 17:35:49

OperationId:ReadSmsNumber

Returns one SMS number in the domain in the path, with its assignment and carrier.

Requires a token for the domain in the path, or Reseller or Super User scope. Basic User, Advanced User, Simple User, and Call Center Agent see only numbers routed to themselves. A Site Manager sees only numbers routed to users in its own site.

The response is an array that holds the number, or an empty array when the number is not in this domain or is not one you can see. Use it to confirm a create, update, or delete, which are applied shortly after they are accepted.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200OK

application/json

An array holding the number, or an empty array when it is not in this domain or not one you can see.

Bodyapplication/json

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains/example.com/smsnumbers/15555550100' \
--header 'Authorization: Bearer <token>'

Response Example

200 - SMS number

[
    {
        "number": "15555550100",
        "application": "user",
        "domain": "example.com",
        "dest": "1001",
        "carrier": "bandwidth",
        "notes": "",
        "mms-capable": true,
        "group-mms-capable": true
    }
]

Modified at 2026-10-03 17:35:49

Get SMS Numbers for Domain

Count domain SMS numbers