Tokens API v1 - GET all tokens

We have a new version of this API—API authentication tokens API. Check it out!

Lists all Dynatrace API authentication tokens of your environment. The list contains only the names and IDs of tokens. You can retrieve details either by the ID of the token or by the token itself.

The request produces an application/json payload.

  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/tokens
  • SaaS https://{your-environment-id}
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v1/tokens


To execute this request, you need the Token management (TenantTokenManagement) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.


Parameter Type Description In Required
limit integer

Limits the maximum number of returned tokens.

If not set the value of 1000 is used.

Maximum value is 1000000.

query optional
user string

Filters the resulting set of tokens by user, who owns the token.

query optional
permissions array

Filters the resulting set of tokens by scopes assigned to the token.

You can specify several permissions in the following format: permissions=scope1&permissions=scope2. The token must have all the specified scopes.

query optional
from integer

Last used after this timestamp (UTC milliseconds).

query optional
to integer

Last used before this timestamp (UTC milliseconds).

query optional


Response codes

Code Description


Response body

The StubList object

An ordered list of short representations of Dynatrace entities.

Element Type Description
values EntityShortRepresentation[]

An ordered list of short representations of Dynatrace entities.

The EntityShortRepresentation object

The short representation of a Dynatrace entity.

Element Type Description
id string

The ID of the Dynatrace entity.

name string

The name of the Dynatrace entity.

description string

A short description of the Dynatrace entity.


In this example, the request lists all API tokens of the mySampleEnv environment.

The API token is passed in the Authorization header.

The result is truncated to three entries.


curl -X GET \ \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

Response body

  "values": [
      "id": "d5836312-5790-4e80-afcf-09971954c3ea",
      "name": "admin"
      "id": "ab42e02c-fbbe-413c-b225-9a87d5efbd60",
      "name": "dev token"
      "id": "434d9b21-1e38-4be3-8b90-5a76d531ca53",
      "name": "devops"

Response code