List user push registrations

GET

/domains/{domain}/users/{user}/push

Last modified:2026-10-30 21:23:42

OperationId:ListPushConfigurationsUser

Lists one user's push registrations: each push token the user's apps registered and the device it notifies. An app reads its own with /domains/~/users/~/push. Requires Reseller, Super User, or Super User Read Only scope to read another user; every other scope reads only its own. For the devices without their 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 user'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//users//push?push-device=sip%3A1001a%40example.com&push-network=apns&limit=undefined&start=undefined&sort=push-device%20asc&push-device-token=a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90&push-test=no&include-secrets=yes' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Own registrations

Read by user 1001 itself: token in clear.

[
    {
        "push-device-token": "a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
        "domain": "example.com",
        "user": "1001",
        "push-device": "sip:1001a@example.com",
        "push-network": "apns",
        "push-test": "no"
    }
]

Modified at 2026-10-30 21:23:42

List domain push registrations