List active users for an organizational level

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

List active users in Dynatrace for an organizational level with the IAM API, filtered by partialString or UUID and sorted by name and surname.

Overview

Providing value for at least one of the parameters: 'partialString' or 'uuid' is required. If both query params 'partialString' and 'uuid' are provided then the result returns users meeting any of the filtering criteria. Returned users are first ordered by name and then by surname. 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:users:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Response

{
  "results": [
    {
      "uid": "string",
      "email": "string",
      "name": "string",
      "surname": "string",
      "description": "string"
    }
  ],
  "nextPageKey": "string",
  "totalCount": 1
}

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