GET/api/admin/users/{uid}/tokensAdmin

List a user's issued tokens

Lists the most recent 200 access / refresh tokens recorded for the user in the issued-tokens audit table, optionally filtered by kind.

operationId get_api_admin_users_uid_tokensAdministration

Authentication & permissionsAdmin

Platform administrators only

Accepted credentials
Who may call
Platform administrators only

Path parameters

NameTypeDescription
uid*string (uuid)

uid of the target user

Query parameters

NameTypeDescription
token_type"access" | "refresh"

Only list tokens of this kind

Responses

application/json
PropertyTypeDescription
success*true
message*string
data*object
tokens*AdminIssuedToken[]
jti*string

Token id (jti claim)

uid*string
token_type*"access" | "refresh"

Kind of issued token

client_app_id*string
audience*string

API server id or resource URL the token was minted for

grant_type*"refresh_token" | "authorization_code" | "client_credentials" | "token_exchange" | "device_code"

The grant that minted the token (token_exchange: an RFC 8693 delegated token; device_code: the RFC 8628 device authorization grant)

issued_at*number | string

Unix epoch milliseconds (a number, or its decimal string form from the database driver)

expires_at*number | string

Unix epoch milliseconds (a number, or its decimal string form from the database driver)

refresh_jti*string | null | null

For access tokens: the jti of the refresh token minted in the same grant; null otherwise

session_idstring | null | null

The session the token belongs to: the jti of the first refresh token of its rotation chain, shared by every token issued in the session. Signing out or revoking any of its refresh tokens revokes them all; null for tokens of no session

JSONExample
"success"true
"message""string"
"data"
"tokens"

Example request

bashcurl
curl -X GET 'https://auth.botreeinc.com/api/admin/users/<uid>/tokens' \
  -b 'refresh_token_<auth_server_app_id>=<value>'
GET /api/admin/users/{uid}/tokens | Botree Auth API