List visible groups from an organizational level

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

List visible groups from a Dynatrace IAM organizational level with the Identity and Access Management API, filtering by partialGroupName or group UUIDs.

Overview

Providing value for at least one of the parameters: 'partialGroupName' or 'uuid' is required. If both query params 'partialGroupName' and 'uuid' are provided then the result will be all of the groups meeting any of the filtering criteria. Authorization is based on an assignment of the calling user to the account associated with the 'level-type' and 'level-id' For environment 'level-type' user has to be assigned to account to which the environment is assigned, user does not need any permissions in such environment

Authentication

To execute this request, you need a platform token or OAuth access token with iam:groups:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Response

{
  "results": [
    {
      "uuid": "string",
      "groupName": "string",
      "type": "LOCAL"
    }
  ],
  "nextPageKey": "string",
  "totalCount": 1
}

{
  "error": {
    "code": 1,
    "message": "string",
    "details": {
      "missingScopes": [
        "string"
      ],
      "constraintViolations": [
        {
          "path": "string",
          "message": "string",
          "parameterLocation": "string"
        }
      ]
    }
  }
}