boundary/website/content/docs/commands/auth-tokens/list.mdx

---
layout: docs
page_title: auth-tokens list - Command
description: >-
  The "auth-tokens list" command lists the available auth token resources within an enclosing scope or resource.
---

⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️
> [!IMPORTANT]  
> **Documentation Update:** Product documentation previously located in `/website` has moved to the [`hashicorp/web-unified-docs`](https://github.com/hashicorp/web-unified-docs) repository, where all product documentation is now centralized. Please make contributions directly to `web-unified-docs`, since changes to `/website` in this repository will not appear on developer.hashicorp.com.
⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️

# auth-tokens list

Command: `boundary auth-tokens list`

The `auth-tokens list` command lists all auth tokens within an enclosing scope or
resource.


## Examples

The following command lists all auth tokens recursively from any child scopes, if applicable:

```shell-session
$ boundary auth-tokens list
```

**Example output:**

<CodeBlockConfig hideClipboard>

```plaintext
Auth Token information:
  ID:                            at_TXmYwSqnnO
    Approximate Last Used Time:  Sun, 13 Aug 2023 18:03:51 PDT
    Auth Method ID:              ampw_1234567890
    Created Time:                Sun, 13 Aug 2023 17:23:16 PDT
    Expiration Time:             Sun, 20 Aug 2023 17:23:16 PDT
    Updated Time:                Sun, 13 Aug 2023 18:03:51 PDT
    User ID:                     u_1234567890
    Authorized Actions:
      no-op
      read
      read:self
      delete
      delete:self

  ID:                            at_Gvd3jsqSO2
    Approximate Last Used Time:  Sun, 13 Aug 2023 18:04:34 PDT
    Auth Method ID:              ampw_1234567890
    Created Time:                Sun, 13 Aug 2023 18:04:34 PDT
    Expiration Time:             Sun, 20 Aug 2023 18:04:34 PDT
    Updated Time:                Sun, 13 Aug 2023 18:04:34 PDT
    User ID:                     u_1234567890
    Authorized Actions:
      no-op
      read
      read:self
      delete
      delete:self
```

</CodeBlockConfig>


## Usage

<CodeBlockConfig hideClipboard>

```shell-session
$ boundary auth-tokens list [options] [args]
```

</CodeBlockConfig>


### Command options

- `-filter` `(string: "")` - If set, the list operation is filtered before it is returned.
The filter operates against each item in the list.
We recommend that you use single quotes, as filters contain double quotes.
Refer to the [Filtering and listing resources documentation](/boundary/docs/filtering) for more details.

- `-recursive`  - If set, the list operation is applied recursively into child scopes, if the type supports it.
The default value is `false`.

- `-scope-id` `(string: "")` - The scope from which to list the auth tokens.
The default value is `global`.
You can also specify this value using the **BOUNDARY_SCOPE_ID** environment variable.

- `list_token` (optional) - An opaque token that is returned from the previous `list` response.
If you do not supply a value, pagination starts from the beginning.
- `page_size` (optional) - An unsigned integer that indicates the number of items that should be included on the page of search results.
If you do not provide a value, or if you provide a value of `0`, Boundary uses the default page size of 1000 items.
If you configure it, the `page_size` value overrides the default page size.
Controller administrators can also configure a `max_page_size` option that constrains the maximum page size a user can request.

@include 'cmd-option-note.mdx'