Skip to main content
GET
List push devices

Endpoints

  • GET /push/devices
  • GET /push/devices/:id
Filter devices by app_id, platform, environment, subscription state, or a device/external ID search. Responses include permission state, SDK/app/OS versions, registration presence, recent activity, contact linkage, and the latest provider error without exposing APNs, FCM, or Web Push credentials. Device initialization, provider registration, permission changes, login, tags, and client events continue to use the app-facing Push API through the device SDKs. These API-key routes are diagnostic and read-only.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:20

Maximum number of records to return. Defaults to 20.

Required range: 1 <= x <= 100
after
string

Opaque cursor from the previous page's metadata.next value.

app_id
string
platform
enum<string>
Available options:
android,
ios,
web
environment
enum<string>
Available options:
production,
development
subscribed
boolean

Response

Push devices returned

status
number
data
unknown
error
unknown
metadata
unknown