--- title: List database tokens description: Use the Admin UI, the influxctl token list command, or the Management HTTP API to list database tokens in your InfluxDB Cloud Dedicated cluster. url: https://docs.influxdata.com/influxdb3/cloud-dedicated/admin/tokens/database/list/ estimated_tokens: 5131 product: InfluxDB Cloud Dedicated version: cloud-dedicated --- # List database tokens Use the Admin UI, the [`influxctl` CLI](/influxdb3/cloud-dedicated/reference/cli/influxctl/), or the [Management HTTP API](/influxdb3/cloud-dedicated/api/management/) to list database tokens in your InfluxDB Cloud Dedicated cluster. - [List database tokens](#list-database-tokens) - [Retrieve a database token by ID](#retrieve-a-database-token-by-id) ## List database tokens **Admin UI:** The InfluxDB Cloud Dedicated administrative UI includes a portal for creating and managing database tokens. Administrators can use this portal to: - View token details - Add read and write permissions for specific databases to a token - Edit a token’s existing read and write permissions for a database - Create a database token - Revoke a database token Access the InfluxDB Cloud Dedicated Admin UI at [console.influxdata.com](https://console.influxdata.com). If you don’t have login credentials, [contact InfluxData support](https://support.influxdata.com). ![InfluxDB Cloud Dedicated Admin UI database tokens](/img/influxdb3/cloud-dedicated-admin-ui-database-tokens.png) Use the **Database Tokens** page to manage authentication tokens for database-level operations: - Create and manage database tokens with granular permissions. - View token status, descriptions, and associated databases. - Edit permissions or revoke existing tokens. - Control access with read and write permissions for specific databases. - Toggle display of inactive tokens. The Database Tokens portal lists all database tokens associated with the cluster and provides the following information about each token: - Token ID - Description - Databases - Status (Active or Revoked) - Created At date - Expires At date You can **Search** tokens by description or ID to filter the list and use the sort button and column headers to sort the list. **influxctl:** 1. If you haven’t already, [download and install the `influxctl` CLI](/influxdb3/cloud-dedicated/reference/cli/influxctl/#download-and-install-influxctl), and then [configure an `influxctl` connection profile](/influxdb3/cloud-dedicated/reference/cli/influxctl/#configure-connection-profiles) for your cluster.2. In your terminal, run the `influxctl token list` command and provide the following: - *Optional*: [Output format](#output-formats) ```sh influxctl token list --format table ``` **Management API:** *This example uses [cURL](https://curl.se/) to send a Management HTTP API request, but you can use any HTTP client.* 1. If you haven’t already, follow the instructions to [install cURL](https://everything.curl.dev/install/index.html) for your system. 2. In your terminal, use cURL to send a request to the following InfluxDB Cloud Dedicated endpoint: [GET https://console.influxdata.com/api/v0/accounts/ACCOUNT\_ID/clusters/CLUSTER\_ID/tokens](/influxdb3/cloud-dedicated/api/database-tokens/#operation/GetDatabaseTokens) In the URL, provide the following credentials: - `ACCOUNT_ID`: The ID of the [account](/influxdb3/cloud-dedicated/get-started/setup/#request-an-influxdb-cloud-dedicated-cluster) that the cluster belongs to *(see how to [list cluster details](/influxdb3/cloud-dedicated/admin/clusters/list/#detailed-output-in-json))*. - `CLUSTER_ID`: The ID of the [cluster](/influxdb3/cloud-dedicated/get-started/setup/#request-an-influxdb-cloud-dedicated-cluster) that you want to manage *(see how to [list cluster details](/influxdb3/cloud-dedicated/admin/clusters/list/#detailed-output-in-json))*. Provide the following request headers: - `Accept: application/json` to ensure the response body is JSON content - `Authorization: Bearer` and a [Management API token](/influxdb3/cloud-dedicated/admin/tokens/management/) for your cluster *(see how to [create a management token](/influxdb3/cloud-dedicated/admin/tokens/management/) for Management API requests)*. The following example shows how to use the Management API to list database tokens: ```sh curl \ --location "https://console.influxdata.com/api/v0/accounts/ACCOUNT_ID/clusters/CLUSTER_ID/tokens" \ --header "Accept: application/json" \ --header "Authorization: Bearer MANAGEMENT_TOKEN" ``` Replace the following in your request: - `ACCOUNT_ID`: the ID of the InfluxDB Cloud Dedicated [account](/influxdb3/cloud-dedicated/get-started/setup/#request-an-influxdb-cloud-dedicated-cluster) to create the database token for - `CLUSTER_ID`: the ID of the InfluxDB Cloud Dedicated [cluster](/influxdb3/cloud-dedicated/get-started/setup/#request-an-influxdb-cloud-dedicated-cluster) to create the database token for - `MANAGEMENT TOKEN`: a [management token](/influxdb3/cloud-dedicated/admin/tokens/management/) for your InfluxDB Cloud Dedicated cluster ## Retrieve a database token by ID To retrieve a specific database token by ID, send a request to the following InfluxDB Cloud Dedicated endpoint: [GET https://console.influxdata.com/api/v0/accounts/ACCOUNT\_ID/clusters/CLUSTER\_ID/tokens/TOKEN\_ID](/influxdb3/cloud-dedicated/api/database-tokens/#operation/GetDatabaseToken) In the URL, provide the following: - `ACCOUNT_ID`: The ID of the [account](/influxdb3/cloud-dedicated/get-started/setup/#request-an-influxdb-cloud-dedicated-cluster) that the cluster belongs to *(see how to [list cluster details](/influxdb3/cloud-dedicated/admin/clusters/list/#detailed-output-in-json))*. - `CLUSTER_ID`: The ID of the [cluster](/influxdb3/cloud-dedicated/get-started/setup/#request-an-influxdb-cloud-dedicated-cluster) that you want to manage *(see how to [list cluster details](/influxdb3/cloud-dedicated/admin/clusters/list/#detailed-output-in-json))*. - `TOKEN_ID`: The ID of the database [token](/influxdb3/cloud-dedicated/admin/tokens/database) that you want to retrieve *(see how to [list token details](/influxdb3/cloud-dedicated/admin/tokens/database/list/#detailed-output-in-json))*. Provide the following request headers: - `Accept: application/json` to ensure the response body is JSON content - `Authorization: Bearer` and a [Management API token](/influxdb3/cloud-dedicated/admin/tokens/management/) for your cluster *(see how to [create a management token](/influxdb3/cloud-dedicated/admin/tokens/management/) for Management API requests)*. ```sh curl \ --location "https://console.influxdata.com/api/v0/accounts/ACCOUNT_ID/clusters/CLUSTER_ID/tokens/TOKEN_ID" \ --header "Accept: application/json" \ --header "Authorization: Bearer MANAGEMENT_TOKEN" \ ``` Replace the following: - `ACCOUNT_ID`: the ID of the InfluxDB Cloud Dedicated [account](/influxdb3/cloud-dedicated/get-started/setup/#request-an-influxdb-cloud-dedicated-cluster) to create the database token for - `CLUSTER_ID`: the ID of the InfluxDB Cloud Dedicated [cluster](/influxdb3/cloud-dedicated/get-started/setup/#request-an-influxdb-cloud-dedicated-cluster) to create the database token for - `MANAGEMENT TOKEN`: a [management token](/influxdb3/cloud-dedicated/admin/tokens/management/) for your InfluxDB Cloud Dedicated cluster - `TOKEN_ID`: a [database token](/influxdb3/cloud-dedicated/admin/tokens/database/) ID ### Output formats The `influxctl token list` command supports two output formats: `table` and `json`. By default, the command outputs the list of tokens formatted as a table. The Management API outputs JSON format in the response body. #### Detailed output in JSON For additional token details and easier programmatic access to the command output, include `--format json` with your command to format the list as JSON. ```sh influxctl token list --format json ``` The output is a JSON array of token objects that include additional fields such as token ID and permissions. #### Example output **table:** ```sh +--------------------------------------+----------------------+ | ID | DESCRIPTION | +--------------------------------------+----------------------+ | 000x0000-000x-0000-X0x0-X0X00000x000 | read/write for mydb1 | | 000x000X-Xx0X-0000-0x0X-000xX000xx00 | read-only for mydb2 | | 00XXxXxx-000X-000X-x0Xx-00000xx00x00 | write-only for mydb3 | +--------------------------------------+----------------------+ ``` **JSON:** ```json [ { "account_id": "0x0x0x00-0Xx0-00x0-x0X0-00x00XX0Xx0X", "cluster_id": "X0x0xxx0-0XXx-000x-00x0-0X000Xx00000", "id": "000x0000-000x-0000-X0x0-X0X00000x000", "description": "read/write for mydb1", "permissions": [ { "id": "00000000-0000-0000-0000-000000000000", "action": "read", "resource": "mydb1" } ] }, { "account_id": "0x0x0x00-0Xx0-00x0-x0X0-00x00XX0Xx0X", "cluster_id": "X0x0xxx0-0XXx-000x-00x0-0X000Xx00000", "id": "000x000X-Xx0X-0000-0x0X-000xX000xx00", "description": "read-only for mydb2", "permissions": [ { "id": "00000000-0000-0000-0000-000000000000", "action": "read", "resource": "mydb2" } ] }, { "account_id": "0x0x0x00-0Xx0-00x0-x0X0-00x00XX0Xx0X", "cluster_id": "X0x0xxx0-0XXx-000x-00x0-0X000Xx00000", "id": "00XXxXxx-000X-000X-x0Xx-00000xx00x00", "description": "write-only for mydb3", "permissions": [ { "id": "00000000-0000-0000-0000-000000000000", "action": "read", "resource": "mydb3" } ] } ] ``` #### Related - [influxctl token list](/influxdb3/cloud-dedicated/reference/cli/influxctl/token/list/)