> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Push Devices

> List registered browsers and app installs

# List Push Devices

Lists registered push devices in a stable order; use `nextCursor` to page. Tokens are never returned in full; `tokenPreview` shows the last characters. Requires the `subscribers:read` scope.

## Request

<ParamField query="email" type="string">
  Only this contact's devices.
</ParamField>

<ParamField query="subscriberId" type="string">
  Only this subscriber's devices.
</ParamField>

<ParamField query="platform" type="string">
  `web`, `ios`, or `android`.
</ParamField>

<ParamField query="status" type="string">
  `active`, `invalid` (rejected by the push service), or `unsubscribed`.
</ParamField>

<ParamField query="limit" type="number" default="50">
  Page size, 1 to 100.
</ParamField>

<ParamField query="cursor" type="string">
  `nextCursor` from the previous page.
</ParamField>

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/push/devices?email=jane@example.com" \
  --header "Authorization: Bearer $SEQUENZY_API_KEY"
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "devices": [
      {
        "id": "dev_123",
        "subscriberId": "sub_456",
        "platform": "ios",
        "status": "active",
        "invalidReason": null,
        "source": "api",
        "deviceName": "Jane iPhone",
        "userAgent": null,
        "appVersion": "3.2.0",
        "osVersion": "18.1",
        "locale": "en-US",
        "timezone": "America/New_York",
        "tokenPreview": "…9f3a21bc",
        "lastSeenAt": "2026-10-01T12:00:00.000Z",
        "createdAt": "2026-09-20T09:30:00.000Z"
      }
    ],
    "nextCursor": null
  }
  ```

  ```json 401 theme={null}
  {
    "error": "Invalid API key"
  }
  ```

  ```json 403 theme={null}
  {
    "error": "API key is missing required scope: subscribers:read"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Subscriber not found."
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.