List SMS blocks

GET

/domains/{domain}/smsblocks

Last modified:2026-10-09 00:39:46

OperationId:ReadSMSBlocksDomain

Returns the SMS opt-outs of a domain, the newest first. Requires Reseller, Super User, or Super User Read Only scope. A Reseller reads the domains in its territory.

An SMS block is an opt-out: an off-net number texted STOP to one of your numbers. The platform adds the block on STOP and sets it inactive on START. While it is active, an SMS or MMS from blocked-number to requesting-number is refused.

Only active blocks are returned unless you send status. limit defaults to 100.

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 blocks. 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//smsblocks?limit=undefined&status=inactive&requesting-number=5555550142&blocked-number=5555550100&offset=0' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Active blocks

[
    {
        "id": "8d5e957f297893487bd98fa830fa6413b2d6f6a1",
        "requesting-number": "+15555550142",
        "blocked-number": "+15555550100",
        "domain": "example.com",
        "status": "active",
        "created-datetime": "2026-09-01T14:30:00+00:00",
        "last-modified-datetime": "2026-09-01T14:30:00+00:00"
    },
    {
        "id": "0f1e2d3c4b5a69788796a5b4c3d2e1f00f1e2d3c",
        "requesting-number": "+15555550143",
        "blocked-number": "+15555550100",
        "domain": "example.com",
        "status": "active",
        "created-datetime": "2026-08-28T10:02:11+00:00",
        "last-modified-datetime": "2026-08-28T10:02:11+00:00"
    }
]

Modified at 2026-10-09 00:39:46

Create domain dial policy

List SMS blocks in all domains