---
title: "List Tokens"
method: GET
path: "/api/v2/oauth/tokens"
tags: ["OAuth Tokens"]
---

# List Tokens

`GET /api/v2/oauth/tokens`

Returns the properties of the tokens for the current user. Admins can view OAuth token properties for all users using the [all](/api-reference/ticketing/oauth/oauth_tokens/#parameters) parameter. The [client_id](/api-reference/ticketing/oauth/oauth_tokens/#parameters) parameter can be included to filter that list by a global or local OAuth client ID. For security reasons, only the first 10 characters of each access token are included.

#### Pagination

* Cursor pagination (recommended)
* Offset pagination

See [Pagination](/api-reference/introduction/pagination/).

Returns a maximum of 100 records per page.

#### Allowed For

* Admins

## Query parameters

- `page[before]` string
- `page[after]` string
- `page[size]` integer

## Response `200`

Success response

- OAuthTokensResponse
  - `tokens` OauthTokenObject[]
    - `client_id` integer — The id of the client this token belongs to
    - `created_at` string, date-time — The time the token was created
    - `expires_at` string, date-time — The time the token will expire
    - `id` integer — Automatically assigned upon creation
    - `refresh_token` string — The refresh token, if generated
    - `refresh_token_expires_at` string, date-time — The time the refresh token will expire
    - `scopes` string[] — An array of the valid scopes for this token. See [Scopes](#scopes) below
    - `token` string — The access token
    - `url` string — The API url of this record
    - `used_at` string, date-time — The latest time this token was used for authentication
    - `user_id` integer — The id of the user this token authenticates as

## Changes

> 29 revisions in range; 1 not diffed.

- **2025-06-12** `edbf399da815` — 3 info
  - added the new optional `query` request parameter `page[after]`
  - added the new optional `query` request parameter `page[before]`
  - added the new optional `query` request parameter `page[size]`

[Change history](https://skmtc.dev/botbrains-io/apis/support-api/changes/api/v2/oauth/tokens/get.md)

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)