---
title: "List an user's APNs tokens"
method: GET
path: "/users/{user_id}/channels/mobile_push/apns/tokens"
tags: ["mobile_push", "apns"]
---

# List an user's APNs tokens

`GET /users/{user_id}/channels/mobile_push/apns/tokens`

Lists all APNs tokens associated with a specific user. This endpoint is available to project administrators and returns a paginated list of tokens, including both active and revoked tokens.

## Path parameters

- `user_id` string, required

## Query parameters

- `limit` integer
- `starting_after` string
- `ending_before` string

## Response `200`

OK

- APNSTokenCollection
  - `data` APNSToken[]
    - `app_id` string — The bundle identifier of the application registering this token. Use this to override the default identifier configured on the APNs integration.
    - `created_at` string, date-time, required — The timestamp when the token was created.
    - `device_token` string, required — The APNs device token to register with MagicBell.
    - `discarded_at` string, date-time, nullable — The timestamp when the token was discarded, if applicable.
    - `id` string, required — The unique identifier for the token.
    - `installation_id` 'development' | 'production' — The APNs environment this token belongs to. If omitted we assume it targets `production`.
    - `updated_at` string, date-time, nullable — The timestamp when the token metadata last changed.
  - `links` Links
    - `first` string
    - `next` string, nullable
    - `prev` string, nullable

---

[API](https://skmtc.net/magicbell/apis/magicbell-api.md) · [All operations](https://skmtc.net/magicbell/apis/magicbell-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/magicbell/magicbell-api/revisions/8b99dca11019/schema)
