List domain push registrations

GET

/domains/{domain}/push

Last modified:2026-10-09 00:53:16

OperationId:ListPushConfigurationsDomain

Lists the push registrations in one domain: each device token a mobile or web app registered, the device it notifies, and the user who owns it.

Who can call it:

Reseller reads domains in its territory.

Super User and Super User Read Only read any domain.

Scopes below Reseller read only their own registrations, and must add user with their own user (or ~). Without it they get 403.

push-device-token is a credential. It is returned in clear only to the registration's own user. Every other caller gets it masked: a long token shows only its first 2 and last 2 characters. A Super User gets it in clear by adding include-secrets=yes, and every such read is logged.

Filters combine with AND. Paging uses limit (default 100, at most 1,000) and start. An empty result is []. For the devices alone, without tokens, add /list to the path.

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 registrations. No match returns an empty array.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//push?push-device=sip%3A1001a%40example.com&push-network=apns&limit=undefined&start=undefined&sort=push-device%20asc&user=1001&push-device-token=a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90&push-test=no&include-secrets=yes' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Registrations

Read by a Reseller: every token masked.

[
    {
        "push-device-token": "a1************************************************************90",
        "domain": "example.com",
        "user": "1001",
        "push-device": "sip:1001a@example.com",
        "push-network": "apns",
        "push-test": "no"
    },
    {
        "push-device-token": "dE***********************************************************************************************00",
        "domain": "example.com",
        "user": "1002",
        "push-device": "sip:1002a@example.com",
        "push-network": "firebase",
        "push-test": "no"
    }
]

Modified at 2026-10-09 00:53:16

List push registrations

List user push registrations