# List Tokens

Launch stage: GA

`GET /api/2.0/token-management/tokens`

Lists all tokens associated with the specified workspace or user.

API scopes: authentication

## Query parameters

- `created_by_id` (int64, optional)
  User ID of the user that created the token.
- `created_by_username` (string, optional)
  Username of the user that created the token.

## Returns

- `token_infos` (array of object, optional)
  Token metadata of each user-created token in the workspace
  - `token_id` (string, optional)
    ID of the token.
    Example: `5684c955822ac792a51ae2aeb80190f13457bab3e2e2934c133a08b38454816c`
  - `creation_time` (int64, optional)
    Timestamp when the token was created.
    Example: `1580265020299`
  - `expiry_time` (int64, optional)
    Timestamp when the token expires.
    Example: `1580265020299`
  - `comment` (string, optional)
    Comment that describes the purpose of the token, specified by the token creator.
    Example: `This is for the ABC department automation scripts.`
  - `created_by_id` (int64, optional)
    User ID of the user that created the token.
    Example: `202480738464078`
  - `created_by_username` (string, optional)
    Username of the user that created the token.
    Example: `jsmith@example.com`
  - `owner_id` (int64, optional)
    User ID of the user that owns the token.
    Example: `202480738464078`
  - `workspace_id` (int64, optional)
    If applicable, the ID of the workspace that the token was created in.
    Example: `5750939285643220`
  - `last_used_day` (int64, optional)
    Approximate timestamp for the day the token was last used. Accurate up to 1 day.
    Example: `1710374400000`
  - `scopes` (array of string, optional)
    Scope of the token was created with, if applicable.

## Response

```json
{
  "token_infos": [
    {
      "token_id": "5684c955822ac792a51ae2aeb80190f13457bab3e2e2934c133a08b38454816c",
      "creation_time": 1580265020299,
      "expiry_time": 1580265020299,
      "comment": "This is for the ABC department automation scripts.",
      "created_by_id": 202480738464078,
      "created_by_username": "jsmith@example.com",
      "owner_id": 202480738464078,
      "workspace_id": 5750939285643220,
      "last_used_day": 1710374400000,
      "scopes": [
        "string"
      ]
    }
  ]
}
```