Get User Details
POST/getUser
This method returns a List
of Users in SSM.
The Authorization
must have Bearer
followed by Token
.
Optional params:
username
- Specify the username for which you want to get the user attribute details,
responsefields
- User attributes which you want to see in the response(for encrypted values, mention ecp<1-5>, and for hashed values, mention hcp<1-5>),
max
,
offset
,
sort
,
order
- asc/desc,
manager
- username,
secondarymanager
- userkey OR secondaryManager
- username
showsecurityanswers
- "0"/"1" to display encrypted security answers for the user
Β
filtercriteria
- User fields based on which you want to get the user attribute details(including userkey),
OR
searchCriteria
- search for a user based on the string passed (eg - β*ab*β or β*abβ or βab*β) in their firstname, lastname, displayname and username only, example - "ab*" - This will return all users with firstname or lastname or username starting with "ab"
OR
advsearchcriteria
- search for a user based on the string passed (eg - β*ab*β or β*abβ or βab*β), example - {"username":"a*", "firstname":"*b"} - This will return all users with username starting with "a" AND firstname ending with "b". Exact match search is applicable for types boolean, users, customer. Date can be entered in format - yyyy-MM-dd.
OR
userQuery
- Sample: βuserQueryβ:βuser.customproperty1='abc' or user.displayname like '%display%'β.
Note - By default, if no responsefields param is passed, required attrs that will always return are username, email, statuskey, firstname, lastname, employeeid along with other attributes with nonblank values only.
Requestβ
- application/json
Body
filtercriteria
object
Responsesβ
- 200
Get User Details / Get User Details 2
Response Headers
Access-Control-Allow-Credentials
string
Access-Control-Allow-Origin
string
Cache-Control
string
Date
string
Expires
string
Referrer-Policy
string
Server
string
Set-Cookie
string
Strict-Transport-Security
string
X-Content-Type-Options
string
X-Frame-Options
string
- application/json
- Schema
- Example (from schema)
- Get User Details
- Get User Details 2
Schema
Array [
]
userlist
object[]
{
"displaycount": "1",
"errorCode": "0",
"msg": "Successful",
"totalcount": "1",
"userlist": [
{
"firstname": "John",
"statuskey": "1",
"userKey": 5,
"username": "johndoe"
}
]
}
{
"displaycount": "1",
"errorCode": "0",
"msg": "Successful",
"totalcount": "1",
"userlist": [
{
"firstname": "John",
"statuskey": "1",
"userKey": 5,
"username": "johndoe"
}
]
}
{
"displaycount": "1",
"errorCode": "0",
"msg": "Successful",
"totalcount": "1",
"userlist": [
{
"accountExpired": "false",
"accountLocked": "false",
"city": "San Francisco",
"companyname": "Global Modern Services, Inc. (USA)",
"costcenter": "GMS USA",
"country": "USA",
"createdate": "06/08/2020T10:35:46+0000",
"customer": "testorg",
"customproperty1": "3aa5550b7fe348b98d7b5741afc65534",
"displayname": "Logan McNeil",
"email": "test@gmail.com",
"employeeType": "Regular",
"employeeid": "21001",
"enabled": "true",
"encryptedSecurityAnswers": "lhCSZZbYyxHaRZN6L9s4IPXAIwx86J87GEXwt5wIutPnEGkywv4W9UImm9u+qlk67bTNecLwHBClApo9olYBEceyC+h4gcLrjWwLOLlJ3Wc=",
"failedTries": "0",
"firstname": "Logan",
"lastPasswordUpdateDate": "07/23/2020T18:25:58+0000",
"lastname": "McNeil",
"location": "San Francisco",
"passwordExpired": "false",
"phonenumber": "415789-8904",
"preferedFirstName": "Logan",
"savUpdateDate": "06/08/2020T10:36:03+0000",
"statuskey": "1",
"systemUserName": "lmcneil",
"title": "Chief Human Resources Officer",
"updatedate": "07/23/2020T18:25:58+0000",
"updateuser": "admin",
"userKey": 12444,
"userSource": "127",
"username": "lmcneil"
}
]
}