---
title: "List push devices"
method: GET
path: "/push/devices"
tags: ["Push"]
---

# List push devices

`GET /push/devices`

## Request

- Base URL: `https://api.sequenzy.com/api/v1`
- URL: `https://api.sequenzy.com/api/v1/push/devices`
- Auth: HTTP bearer

Lists registered browsers and app installs in a stable order; page with the returned cursor. Tokens are never returned in full. Requires the subscribers:read scope.

## Query parameters

- `email` string
- `subscriberId` string
- `platform` 'web' | 'ios' | 'android'
- `status` 'active' | 'invalid' | 'unsubscribed'
- `limit` integer
- `cursor` string

## Response `200`

Devices

- object
  - `success` boolean
  - `devices` PushDevice[]
    - `id` string
    - `subscriberId` string, nullable: Linked contact, or null for anonymous browsers.
    - `platform` 'web' | 'ios' | 'android'
    - `status` 'active' | 'invalid' | 'unsubscribed'
    - `invalidReason` string, nullable: Why the push service rejected the token, for invalid devices.
    - `source` 'web_sdk' | 'mobile_sdk' | 'api': web_sdk for browsers, mobile_sdk for devices the iOS, Android, React Native and Flutter SDKs registered, api for devices registered with a secret key.
    - `deviceName` string, nullable
    - `userAgent` string, nullable
    - `appVersion` string, nullable
    - `osVersion` string, nullable
    - `locale` string, nullable
    - `timezone` string, nullable
    - `tokenPreview` string: Last characters of the token.
    - `lastSeenAt` string, date-time
    - `createdAt` string, date-time
  - `nextCursor` string, nullable: Pass as cursor to fetch the next page; null on the last page.

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Missing subscribers:read scope
- `404`: Contact not found (when filtering by email or subscriberId)
- `500`: Server error

## Changes

- **2026-10-20** `54f67ac2d016`: 1 warning
  - added the new `mobile_sdk` enum value to the `devices/items/source` response property for the response status `200`
- **2026-10-16** `db3873ca3d4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/push/devices/get.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) - [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sequenzy/apis/sequenzy-api/revisions/3d816357b738?raw)