> ## 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.

> [!NOTE]
>
> This command is only available on Astro.

List all [API tokens](https://astronomer.io/docs/astro/deployment-api-tokens.md) belonging to a Deployment.

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

## 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`](https://astronomer.io/docs/cli/v1.47/astro-deployment-token-create)
* [`astro deployment token update`](https://astronomer.io/docs/cli/v1.47/astro-deployment-token-update)
* [`astro deployment token rotate`](https://astronomer.io/docs/cli/v1.47/astro-deployment-token-rotate)