Platform tokens API - GET all a platform token

  • Latest Dynatrace
  • Reference
  • Published Dec 04, 2025

Lists all platform tokens of your Dynatrace account.

The request produces an application/json payload.

GET

https://api.dynatrace.com/iam/v1/accounts/{accountUuid}/platform-tokens

Authentication

To execute this request, you need the Allow read access for identity resources (users and groups) (account-idm-read) scope assigned to your token. To learn how to obtain and use it, see OAuth clients.

Parameters

ParameterTypeDescriptionInRequired
accountUuidstring

The ID of the required account.

You can find the UUID on the Account Management > Identity & access management > OAuth clients page, during creation of an OAuth client.

pathRequired
searchTermstring

Optional search term. Only platform tokens that match values of tokenId, name, createdBy or scope will be returned.

queryOptional
statusstring

Optional platform token status. Only platform tokens that status matches the value will be returned.

queryOptional
pagenumber

The number of the requested page.

queryOptional
sizenumber

Defines the requested number of entries for the next page.

queryOptional

Response

Response codes

CodeTypeDescription
200PlatformTokenPageDto

Successful response - platform tokens fetched.

Response body objects

The PlatformTokenPageDto object

ElementTypeDescription
pageSizenumber

Page size.

pageNumbernumber

Page number.

totalnumber

Total count of entries.

resultsPlatformTokenDto[]-

The PlatformTokenDto object

ElementTypeDescription
tokenIdstring-
accountUuidnumber-
descriptionstring-
namestring-
scopestring[]-
tagsstring[]-
resourcestring[]-
expirationDatestring-
userUuidstring-
metadataPlatformTokenMetadataDto-

The PlatformTokenMetadataDto object

ElementTypeDescription
lastUsedAtstring-
lastClientIdstring-

Response body JSON models

{
  "pageSize": 1,
  "pageNumber": 1,
  "total": 1,
  "results": [
    {
      "tokenId": "string",
      "accountUuid": 1,
      "description": "string",
      "name": "string",
      "scope": [
        "string"
      ],
      "tags": [
        "string"
      ],
      "resource": [
        "string"
      ],
      "expirationDate": "string",
      "userUuid": "string",
      "metadata": {
        "lastUsedAt": "string",
        "lastClientId": "string"
      }
    }
  ]
}

Example

In this example, the request lists all platform tokens assigned to the accountUuid 2b794097-8ad2-4b32-b923-0131da2eeddf account. The example result is truncated to three entries.

Curl

curl -X 'GET' \
  'https://api-dev.internal.dynatracelabs.com/iam/v1/accounts/2b794097-8ad2-4b32-b923-0131da2eeddf/platform-tokens' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eywedGciOiJFUzI1NiIsInR7cCI6IkpCDVIsImtpZCI6IjEifQ'

Request URL

https://api-dev.internal.dynatracelabs.com/iam/v1/accounts/2b794097-8ad2-4b32-b923-0131da2eeddf/platform-tokens

Response body

{
  "pageSize": 1000,
  "pageNumber": 1,
  "total": 9,
  "results": [
    {
      "tokenId": "dt0s34.DEFO9UNM",
      "accountUuid": "2b794097-8ad2-4b32-b923-0131da2eeddf",
      "name": "PT_MCP",
      "scope": [
        "settings:objects:read",
      ],
      "resource": [
        "urn:dtaccount:2b794097-8ad2-4b32-b923-0131da2eeddf"
      ],
      "status": "ACTIVE",
      "expirationDate": "2026-12-01T00:00:00Z",
      "createdAt": "2025-06-23T11:10:21Z",
      "updatedAt": "2025-12-23T11:10:21Z",
      "createdBy": "test.abc@dynatrace.com",
      "owner": "test.abc@dynatrace.com",
      "metadata": {
        "lastUsedAt": null,
        "lastClientIp": null
      }
    },
    {
      "tokenId": "dt0s34.CVB5GHJ",
      "accountUuid": "2b794097-8ad2-4b32-b923-0131da2eeddf",
      "name": "PT_external_access",
      "scope": [
        "storage:logs:write",
        "storage:logs:read"
      ],
      "resource": [
        "urn:dtaccount:2b794097-8ad2-4b32-b923-0131da2eeddf"
      ],
      "status": "ACTIVE",
      "expirationDate": "2025-10-31T00:00:00Z",
      "createdAt": "2025-09-03T13:59:57Z",
      "updatedAt": "2025-09-03T13:59:57Z",
      "createdBy": "test.abc@dynatrace.com",
      "owner": "e2erf9d3-ed46-3df4-ae4e-2dfg1c8d5678@service.sso.dynatrace.com",
      "metadata": {
        "lastUsedAt": null,
        "lastClientIp": null
      }
    },
    {
      "tokenId": "dt0s34.VBMJOO4W",
      "accountUuid": "2b794097-8ad2-4b32-b923-0131da2eeddf",
      "name": "test abc env",
      "scope": [
        "app-engine:apps:install"
      ],
      "resource": [
        "urn:dtenvironment:yqx04564"
      ],
      "status": "ACTIVE",
      "expirationDate": "2025-10-07T00:00:00Z",
      "createdAt": "2025-09-30T05:39:56Z",
      "updatedAt": "2025-09-30T05:40:34Z",
      "createdBy": "test2.abc@dynatrace.com",
      "owner": "2d3cd3e8-c456-4b59-958e-220924a345670@service.sso.dynatrace.com",
      "metadata": {
        "lastUsedAt": null,
        "lastClientIp": null
      }
    },
  ]
}

Response code

200