---
title: "List a user's widget tokens (admin)"
method: GET
path: "/api/admin/users/{userId}/widget-tokens"
tags: ["Admin"]
---

# List a user's widget tokens (admin)

`GET /api/admin/users/{userId}/widget-tokens`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/admin/users/{userId}/widget-tokens`
- Auth: HTTP bearer

Requires a Clerk session with a platform admin role. Returns widget token metadata (`id`, `deviceId`, `platform`, `scopes`, `createdAt`, `lastUsedAt`, `expiresAt`, `revokedAt`) for a user. Never returns `tokenHash` or raw tokens.

## Path parameters

- `userId` string, required

## Response `200`

Widget token metadata list

- object
  - `success` true, required
  - `data` object, required
    - `tokens` object[], required
      - `id` string, required
      - `deviceId` string, required
      - `platform` 'android' | 'ios', required
      - `scopes` string[], required
      - `createdAt` string, date-time, required
      - `lastUsedAt` string, date-time, nullable, required
      - `expiresAt` string, date-time, required
      - `revokedAt` string, date-time, nullable, required

## Other responses

- `401`: UNAUTHORIZED
- `403`: FORBIDDEN

## Changes

- **2026-11-21** `63735cf90a04`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/admin/users/:userId/widget-tokens/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
