Ask or search…
K
Links

Get a User

Get a specified user
Returns a specified user (acs_user object).
post
https://connect.getseam.com
/acs/users/get
/acs/users/get

Request

Specify the desired user by including the corresponding acs_user_id in the request body.

Request Body Parameters

Parameter
Type
Description
acs_user_id
String Required
ID of the desired user

Sample Request

cURL (bash)
# Use GET or POST.
curl -X 'GET' \
'https://connect.getseam.com/acs/users/get' \
-H 'accept: application/json' \
-H 'Authorization: Bearer ${API_KEY}' \
-H 'Content-Type: application/json' \
-d '{
"acs_user_id": "efaeae64-e471-4e1f-a621-f518c624d99c"
}'

Response

Returns an acs_user containing the following properties:
Property
Description
acs_user_id
ID of the user
display_name
Display name for the user
full_name
Full name of the user
email_address
Email address of the user
phone
Phone number of the user in E.164 format (for example, +15555550100)
external_type
Brand-specific terminology for the user type
external_type_display_name
Display name that corresponds to the brand-specific terminology for the user type
workspace_id
ID of the workspace that contains the user
acs_system_id
ID of the access control system that contains the user
created_at
Date and time at which the user was created
This response also includes a Boolean ok status indicator.

Sample Response

JSON
{
"acs_user": {
"acs_user_id": "efaeae64-e471-4e1f-a621-f518c624d99c",
"display_name": "Jenny Gergenson",
"full_name": "Jenny Gergenson",
"email_address": "[email protected]",
"phone": "+5555550101",
"external_type": "pti_user",
"external_type_display_name": "PTI user",
"acs_system_id": "fc793d86-dcfd-4cfe-859f-0b9c1a5c1360",
"workspace_id": "398d80b7-3f96-47c2-b85a-6f8ba21d07be",
"created_at": "2023-09-28T01:40:51.475Z",
"is_suspended": false
},
"ok": true
}