API authentication tokens API - GET a token

Gets metadata of the API token by its ID.

The request produces an application/json payload.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v2/apiTokens/{id}
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/apiTokens/{id}
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v2/apiTokens/{id}

Authentication

To execute this request, you need the Read API tokens (apiTokens.read) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter Type Description In Required
id string

The ID of the token.

path required

Response

Response codes

Code Description
200

Success

400

Failed. The input is invalid.

404

Failed. The requested resource doesn't exist.

Response body

The ApiToken object

Metadata of an API token.

Element Type Description
lastUsedIpAddress string

Token last used IP address.

lastUsedDate string

Token last used date in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

personalAccessToken boolean

The token is a personal access token (true) or an API token (false).

expirationDate string

Token expiration date in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

creationDate string

Token creation date in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

scopes string[]

A list of scopes assigned to the token.

name string

The name of the token.

id string

The ID of the token, consisting of prefix and public part of the token.

owner string

The owner of the token.

enabled boolean

The token is enabled (true) or disabled (false).