List SMS blocks in all domains

GET

/smsblocks

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

OperationId:ReadSMSBlocksAllDomains

Returns the SMS opt-outs across every domain, the newest first. Requires Reseller, Super User, or Super User Read Only scope. A Reseller gets the blocks of 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. For one domain, use GET /domains/{domain}/smsblocks.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200OK

application/json

The blocks. An empty array when none match.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠420Rate Limit Exceeded

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/smsblocks?limit=undefined&status=inactive&requesting-number=5555550142&blocked-number=5555550100&offset=0' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Blocks in several domains

[
    {
        "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": "9a8b7c6d5e4f30211203f4e5d6c7b8a99a8b7c6d",
        "requesting-number": "+15555550142",
        "blocked-number": "+15555550130",
        "domain": "acme.example.com",
        "status": "active",
        "created-datetime": "2026-09-01T14:30:00+00:00",
        "last-modified-datetime": "2026-09-01T14:30:00+00:00"
    }
]

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

List SMS blocks

Update SMS block