Try it free

List available service users for an organizational level

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

List active service users for an organizational level in Dynatrace with the IAM API, filtered by your permissions and account context.

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

Overview

You use level-type and level-id to choose the organizational level, then page-key, page, and pageSize to page through the results. The response returns active service users from that level that are usable by the execution user.

Authentication

To execute this request, you need a platform token or OAuth access token with iam:service-users:use 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
page-keystring

Cursor-based Pagination - page-key. Cursor to the next page, includes page number and filtering values. Implicit filtering values will be overwritten by page-key property. Cursor-based Pagination can't be used together with Offset-based Pagination! Max length: 2000

queryOptional
pageinteger

Offset-based Pagination - page. Default value: 1. Page number to return. Offset-based Pagination can't be used with Cursor-based Pagination!

queryOptional
pageSizeinteger

Pagination - page size. Default value: 1000. Minimum value: 1. Maximum value: 1000

queryOptional

Response

Response codes

CodeTypeDescription
200SearchResult

Active service users from the organizational level filtered by user permissions fetched successfully

401PublicExceptionMessage

Authorization header is missing or is incorrect.

403PublicExceptionMessage

Execution user is not allowed to perform the action.

404PublicExceptionMessage

The 'level-id' param does not exist

429PublicExceptionThrottlingMessage

Too many requests have been sent - requests are throttled

Response body objects

The SearchResult object

ElementTypeDescription
resultsServiceUserDto[]

Collection containing the paginated result

nextPageKeystring

Key for requesting the next page of the result

totalCountinteger

Total count of records

The ServiceUserDto object

Collection containing the paginated result

ElementTypeDescription
uidstring-
emailstring-
namestring-
surnamestring-
descriptionstring-
createdAtstring-

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

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