---
title: "List Live Activity tokens"
method: GET
path: "/push/live-activities"
tags: ["Push"]
---

# List Live Activity tokens

`GET /push/live-activities`

## Request

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

Lists ActivityKit tokens the Sequenzy iOS SDK reported, with a summary per activity type (for the contact when email or subscriberId is given). push_to_start tokens can start an activity of their type; update tokens address one running activity. Tokens are masked. Requires the subscribers:read scope.

## Query parameters

- `email` string
- `subscriberId` string
- `activityType` string
- `activityId` string
- `kind` 'push_to_start' | 'update'
- `status` 'active' | 'ended' | 'invalid'
- `limit` integer
- `cursor` string

## Response `200`

Tokens and summary

- object
  - `success` boolean
  - `summary` object: Active tokens only, for the contact when one is given. A device that can start several types counts once in pushToStartDevices; several devices running one activity count as one activity.
    - `pushToStartDevices` integer
    - `activeActivities` integer
    - `activityTypes` object[]
      - `activityType` string
      - `pushToStartDevices` integer
      - `activeActivities` integer
  - `tokens` LiveActivityToken[]
    - `id` string
    - `kind` 'push_to_start' | 'update': push_to_start tokens start activities of a type on one device; update tokens address one running activity.
    - `status` 'active' | 'ended' | 'invalid'
    - `activityType` string: The Swift ActivityAttributes type name.
    - `activityId` string, nullable: Your activity id. Null for push-to-start tokens.
    - `subscriberId` string, nullable
    - `deviceId` string, nullable: The push device of the same installation, when the app registered one.
    - `invalidReason` string, nullable: Why the token is invalid, such as `replaced`, `unregistered` or an APNs reason like `Unregistered`.
    - `lastPushOutcome` string, nullable: accepted, invalid_token, credentials_error, failed, retryable, or retrying while a retry is pending.
    - `lastPushError` string, nullable
    - `lastPushAt` string, date-time, nullable
    - `endedAt` string, date-time, nullable
    - `tokenPreview` string: Last eight characters of the token.
    - `lastSeenAt` string, date-time
    - `createdAt` string, date-time
  - `nextCursor` string, nullable

## Other responses

- `401`: Unauthorized
- `403`: Missing subscribers:read scope
- `404`: Contact not found
- `500`: Server error

## Changes

- **2026-10-21** `62f1bc53cfd2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/push/live-activities/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/8156dc12d8b4?raw)