---
title: "Get all tokens"
method: GET
path: "/users/{user_id}/tokens"
tags: ["Device Tokens"]
---

# Get all tokens

`GET /users/{user_id}/tokens`

Returns every device token registered for a user, each with its provider key, status, and expiry date.

## Path parameters

- `user_id` string, required

## Response `200`

- UsersGetAllTokensResponse — A list of tokens registered with the user.
  - `tokens` UsersUserToken[], required
    - `token` string, required — Full body of the token. Must match token in URL path parameter.
    - `provider_key` 'firebase-fcm' | 'apn' | 'expo' | 'onesignal', required
    - `expiry_date` union
      - string
      - boolean
    - `properties` unknown
    - `device` UsersDevice
      - `app_id` string, nullable — Id of the application the token is used for
      - `ad_id` string, nullable — Id of the advertising identifier
      - `device_id` string, nullable — Id of the device the token is associated with
      - `platform` string, nullable — The device platform i.e. android, ios, web
      - `manufacturer` string, nullable — The device manufacturer
      - `model` string, nullable — The device model
    - `tracking` UsersTracking
      - `os_version` string, nullable — The operating system version
      - `ip` string, nullable — The IP address of the device
      - `lat` string, nullable — The latitude of the device
      - `long` string, nullable — The longitude of the device

## Other responses

- `400`

## Changes

- **2025-12-08** `59c9efb45644` — 1 breaking, 1 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - added the required property `tokens` to the response with the `200` status
- **2025-11-07** `71020f2e0980` — 1 info
  - the response property `items/token` became required for the status `200`
- **2025-10-15** `e67d02739533` — 2 info
  - api tag `Device Tokens` added
  - api tag `UsersTokens` removed

[Change history](https://skmtc.dev/trycourier/apis/courier/changes/users/:user_id/tokens/get.md)

---

[API](https://skmtc.dev/trycourier/apis/courier.md) · [All operations](https://skmtc.dev/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trycourier/courier/revisions/cb8586034158/schema)