Try it free

Get an active user from an organizational level

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Retrieve an active user from a Dynatrace IAM organizational level by UUID with the Identity and Access Management API, using the level type and level ID.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/iam/v1/organizational-levels/{level-type}/{level-id}/users/{uuid}

Overview

You use the level-type, level-id, and uuid path parameters to fetch one active user from an organizational level. The response returns the user successfully when Dynatrace authorizes your assignment to the associated account.

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

ParameterTypeDescriptionInRequired
level-typestring

Allowed values: account, environment

pathRequired
level-idstring

Identifier of 'level-type'. Max allowed length is 36. For account use its UUID. 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

pathRequired
uuidstring

User UUID

pathRequired

Response

Response codes

CodeTypeDescription
200RestUserPublic

User fetched successfully

401PublicExceptionMessage

Authorization header is missing or is incorrect.

403PublicExceptionMessage

Execution user is not allowed to perform the action.

404PublicExceptionMessage

Calling user is not assigned to the requested account or requested environment is not assigned to account that user is assigned to or the 'level-id' does not exist

429PublicExceptionThrottlingMessage

Too many requests have been sent - requests are throttled

Response body objects

The RestUserPublic object

Collection containing the paginated result

ElementTypeDescription
uidstring-
emailstring-
namestring-
surnamestring-
descriptionstring-

The PublicExceptionMessage object

ElementTypeDescription
errorErrorResponse-

The ErrorResponse object

ElementTypeDescription
codeinteger-
messagestring-
detailsErrorResponseDetails-

The ErrorResponseDetails object

ElementTypeDescription
missingScopesstring[]-
constraintViolationsErrorResponseConstraintViolation[]-

The ErrorResponseConstraintViolation object

ElementTypeDescription
pathstring-
messagestring-
parameterLocationstring-

Response body JSON models

{
"uid": "string",
"email": "string",
"name": "string",
"surname": "string",
"description": "string"
}
{
"error": {
"code": 1,
"message": "string",
"details": {
"missingScopes": [
"string"
],
"constraintViolations": [
{
"path": "string",
"message": "string",
"parameterLocation": "string"
}
]
}
}
}
Related tags
Platform APIDynatrace Platform