Service user management API - GET a service user

  • Latest Dynatrace
  • Reference
  • Published Dec 04, 2025

Get a service user details in the specified account.git

The request produces an application/json payload.

GET

https://api.dynatrace.com/iam/v1/accounts/{accountUuid}/service-users/{userUuid}

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
userUuidstring

The UUID of the required user.

pathRequired

Response

Response codes

CodeTypeDescription
200ExternalServiceUserWithGroupUuidDto

Success. The user has been fetched.

Response body objects

The ExternalServiceUserWithGroupUuidDto object

ElementTypeDescription
uidstring

UUID of service user

emailstring

Email of service user

namestring

Name of service user

surnamestring

Surname of service user

descriptionstring

The description of the service user

createdAtstring

The date and time when the user was created in 2021-05-01T15:11:00Z format.

groupUuidstring

Uuid of the group which enables assigning policy to service user

Response body JSON models

{
"uid": "string",
"email": "string",
"name": "string",
"surname": "string",
"description": "string",
"createdAt": "string",
"groupUuid": "string"
}

Example

In this example, the request gets a service user with userUuid of 7a1d224d-0ebc-4318-ab1e-64b217b7c156 in the account with accountUuid 2b794097-8ad2-4b32-b923-0131da2eeddf. The example result is truncated to three entries.

Curl

curl -X 'GET' \
'https://api.dynatrace.com/iam/v1/accounts/2b794097-8ad2-4b32-b923-0131da2eeddf/service-users/7a1d224d-0ebc-4318-ab1e-64b217b7c156' \
-H 'accept: application/json' \
-H 'Authorization: Bearer eywedGciOiJFUzI1NiIsInR7cCI6IkpCDVIsImtpZCI6IjEifQ'

Request URL

https://api.dynatrace.com/iam/v1/accounts/2b794097-8ad2-4b32-b923-0131da2eeddf/service-users/7a1d224d-0ebc-4318-ab1e-64b217b7c156

Response body

{
"uid": "7a1d224d-0ebc-4318-ab1e-64b217b7c156",
"email": "7a1d224d-0ebc-4318-ab1e-64b217b7c156@service.sso.dynatrace.com",
"name": "serviceUser1",
"surname": "SERVICE_IDENTITY",
"description": "",
"createdAt": "2024-10-10T07:44:38Z",
"groupUuid": "323c776c-23ff-7896-a0f1-229927aea567"
}

Response code

200