List platform push devices

GET

/push/list

Last modified:2026-10-03 07:48:42

OperationId:ListPush

Lists the devices registered for push across the platform, with their push service and owner, without the tokens.

Who can call it:

Super User and Super User Read Only list every registered device.

Reseller lists devices in domains of its territory.

Every other scope gets 403. Use GET /domains/{domain}/users/{user}/push/list for your own devices.

/list returns the devices registered for push and their push service, never the tokens, so it is safe to show in an admin view. It runs the same read as the path without /list, with the same filters, paging, and access. include-secrets is ignored. /count is not supported for push registrations and returns 405.

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 registered devices you can read. No match returns an empty array.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/push/list?push-device=sip%3A1001a%40example.com&push-network=apns&limit=100&start=0&sort=push-device%20asc&domain=example.com&user=1001' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Devices

[
    {
        "push-device": "sip:1001a@example.com",
        "push-network": "apns",
        "domain": "example.com",
        "user": "1001"
    },
    {
        "push-device": "sip:1002a@example.com",
        "push-network": "firebase",
        "domain": "example.com",
        "user": "1002"
    },
    {
        "push-device": "sip:2001a@acme.example.com",
        "push-network": "apns",
        "domain": "acme.example.com",
        "user": "2001"
    }
]

Modified at 2026-10-03 07:48:42

List rejected SIP requests for a specific host

List push registrations