Get user by id

Prev Next
Get
/identity/users/{userId}

Returns the user identified by the given id.

Required permissions: READ_USER.
Optional permissions: READ_USER_PERMISSIONS.

Security
HTTP
Type bearer
Header parameters
X-Servitly-Tenant
stringRequired

The name of the target tenant (e.g. acme).

Path parameters
userId
stringRequired

The id fo the user to retrieve.

Minimum1.0
Exampleabcd1234
Responses
200

Successful operation

Expand All
object
id
string
email
string
firstName
string
lastName
string
devices
Array of object (Device)
object
deviceId
string
os
string
ExampleAndroid_9, iSO_11
model
string
ExampleONEPLUS A6013
platform
string
Valid values[ "Android", "iOS" ]
notificationDeviceId
string
userTypeName
string
organizationId
string
partnerId
string
customerId
string
locationId
string
timezone
string
language
string
termsOfServiceAcceptedTimestamp
integer (int64)
privacyPolicyAcceptedTimestamp
integer (int64)
firstAccessTimestamp
integer (int64)
lastAccessTimestamp
integer (int64)
hostCustomers
Array of object (HostCustomer)
object
customerId
string
userType
object
id
string
name
string
category
string
rank
integer
commandPayloadDuration
integer
permissions
Array of string
string
status
string
Valid values[ "PENDING_ACTIVATION", "ACTIVE" ]
creationTimestamp
integer (int64)
alertActivatedInformationalEmailEnabled
boolean
alertClearedInformationalEmailEnabled
boolean
alertActivatedWarningEmailEnabled
boolean
alertClearedWarningEmailEnabled
boolean
alertActivatedFailureEmailEnabled
boolean
alertClearedFailureEmailEnabled
boolean
alertActivatedCriticalEmailEnabled
boolean
alertClearedCriticalEmailEnabled
boolean
alertActivatedEmergencyEmailEnabled
boolean
alertClearedEmergencyEmailEnabled
boolean
alertActivatedInformationalSmsEnabled
boolean
alertClearedInformationalSmsEnabled
boolean
alertActivatedWarningSmsEnabled
boolean
alertClearedWarningSmsEnabled
boolean
alertActivatedFailureSmsEnabled
boolean
alertClearedFailureSmsEnabled
boolean
alertActivatedCriticalSmsEnabled
boolean
alertClearedCriticalSmsEnabled
boolean
alertActivatedEmergencySmsEnabled
boolean
alertClearedEmergencySmsEnabled
boolean
alertActivatedInformationalPushEnabled
boolean
alertClearedInformationalPVoicenabled
boolean
alertActivatedWarningPushEnabled
boolean
alertClearedWarningPushEnabled
boolean
alertActivatedFailurePushEnabled
boolean
alertClearedFailurePushEnabled
boolean
alertActivatedCriticalPushEnabled
boolean
alertClearedCriticalPushEnabled
boolean
alertActivatedEmergencyPushEnabled
boolean
alertClearedEmergencyPushEnabled
boolean
alertActivatedInformationalVoiceEnabled
boolean
alertClearedInformationalVoiceEnabled
boolean
alertActivatedWarningVoiceEnabled
boolean
alertClearedWarningVoiceEnabled
boolean
alertActivatedFailureVoiceEnabled
boolean
alertClearedFailureVoiceEnabled
boolean
alertActivatedCriticalVoiceEnabled
boolean
alertClearedCriticalVoiceEnabled
boolean
alertActivatedEmergencyVoiceEnabled
boolean
401

User not authenticated.

object
message
string

The error response.

ExampleUser not authenticated
403

User not authorized.

object
message
string

The error response.

ExampleUser not authorized
404

Resource was not found.

object
message
string

The error response.

ExampleResource not found
429

API call rate limit exeeded.

object
message
string

The error response.

ExampleAPI call rate limit exeeded
500

Internal server error.

object
message
string

The error response.

ExampleInternal Server Error