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

# Get single token

`GET /users/{user_id}/tokens/{token}`

Returns one device token with its provider key, status and status reason, expiry date, and any properties stored alongside it.

## Path parameters

- `user_id` string, required
- `token` string, required

## Response `200`

- UsersGetUserTokenResponse
  - `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-11-07** `71020f2e0980` — 1 info
  - the response property `allOf[subschema #1: UsersUserToken]/token` became required for the status `200`
- **2025-10-15** `e67d02739533` — 2 info
  - api tag `Device Tokens` added
  - api tag `UsersTokens` removed
- **2025-10-10** `1cc4508dc9f8` — 2 info
  - added `#/components/schemas/UsersUserToken` to the response body `allOf` list for the response status `200`
  - removed `#/components/schemas/usersUserToken` from the response body `allOf` list for the response status `200`

[Change history](https://skmtc.dev/trycourier/apis/courier/changes/users/:user_id/tokens/:token/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)