> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# astro deployment token list

> List your Deployment API tokens.

<Info>
  This command is only available on Astro.
</Info>

List all [API tokens](/docs/astro/deployment-api-tokens) belonging to a Deployment.

To use an API token in an automated process, see [Authenticate an automation tool](/docs/astro/automation-authentication).

## Usage

```sh wrap theme={null}
astro deployment token list --deployment-id=<deployment-id>
```

## Options

| Option | Description | Possible Values |
| - | - | - |
| `--deployment-id` | The Deployment to list tokens for. | A valid Deployment ID |
| `--verbosity` | The log level. | `debug`, `info`, `warn`, `error`, `fatal`, or `panic`. Default is `warn`. |
| `--workspace-id` | The Workspace ID for the Deployment. | A valid Workspace ID |

## Output

| Output | Description | Data Type |
| - | - | - |
| `ID` | The token ID. | String |
| `NAME` | The name of the token. | String |
| `DESCRIPTION` | The description of the API Token. | String |
| `SCOPE` | Whether the API Token is scoped to a Deployment, Workspace, or Organization. | String |
| `CREATED` | How long ago the token was created in days. | String |
| `CREATED BY` | The name of the user entity who created the token. | String |

## Examples

```bash wrap theme={null}
# List tokens for a single Deployment
astro deployment token list --deployment-id=clukapi6r000008l58530cg8i
```

## Related commands

* [`astro deployment token create`](/docs/cli/v1.46/astro-deployment-token-create)
* [`astro deployment token update`](/docs/cli/v1.46/astro-deployment-token-update)
* [`astro deployment token rotate`](/docs/cli/v1.46/astro-deployment-token-rotate)