List Users in an Access Group

Get all users for a specified access group

Returns a list of all ACS users in an access group.

/acs/access_groups/list_users

post

Returns a list of all access system users in an access group.

Authorizations

pat_with_workspaceconsole_session_with_workspaceapi_key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

acs_access_group_idstring · uuidRequired

ID of the access group for which you want to retrieve all access system users.

Responses

200

OK

application/json

400

Bad Request

401

Unauthorized

post

/acs/access_groups/list_users

HTTPcURLJavaScriptPython

POST /acs/access_groups/list_users HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 62

{
  "acs_access_group_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "acs_users": [
    {
      "acs_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "acs_system_id": "123e4567-e89b-12d3-a456-426614174000",
      "hid_acs_system_id": "123e4567-e89b-12d3-a456-426614174000",
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-12-16T22:12:20.102Z",
      "display_name": "text",
      "external_type": "pti_user",
      "external_type_display_name": "text",
      "is_suspended": true,
      "access_schedule": {
        "starts_at": "2025-12-16T22:12:20.102Z",
        "ends_at": "2025-12-16T22:12:20.102Z"
      },
      "user_identity_id": "text",
      "user_identity_full_name": "text",
      "user_identity_email_address": "text",
      "user_identity_phone_number": "text",
      "warnings": [
        {
          "created_at": "2025-12-16T22:12:20.102Z",
          "message": "text",
          "warning_code": "being_deleted"
        }
      ],
      "errors": [
        {
          "created_at": "2025-12-16T22:12:20.102Z",
          "message": "text",
          "error_code": "deleted_externally"
        }
      ],
      "pending_mutations": [
        {
          "created_at": "2025-12-16T22:12:20.102Z",
          "message": "text",
          "mutation_code": "creating"
        }
      ],
      "last_successful_sync_at": "2025-12-16T22:12:20.102Z",
      "connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
      "salto_space_metadata": {
        "user_id": "text",
        "audit_openings": true
      },
      "full_name": "text",
      "email_address": "[email protected]",
      "phone_number": "text",
      "is_managed": true
    }
  ],
  "ok": true
}

Request

Specify the access group for which you want to retrieve all users by including the corresponding acs_access_group_id in the request body.

Request Body Parameters

Parameter	Type	Description
acs_access_group_id	String (UUID) Required	ID of the access group for which you want to retrieve all users

Sample Request

Python

seam.acs.access_groups.list_users(
  acs_access_group_id="44444444-4444-4444-4444-444444444444"
)

cURL (bash)

JavaScript

Ruby

PHP

C#

Java

Go

Response

Returns an acs_users array, in which each returned acs_user contains the following properties:

Property	Description
acs_user_id	ID of the ACS user
display_name	Display name for the ACS user
full_name	Full name of the ACS user
email	Email address of the ACS user (for backward compatibility)
email_address	Email address of the ACS user
phone_number	Phone number of the ACS user in E.164 format (for example, [phone])
acs_system_id	ID of the access control system that contains the ACS user
workspace_id	ID of the workspace that contains the ACS user
created_at	Date and time at which the ACS user was created
is_suspended	Indicates whether the ACS user is currently suspended
access_schedule	starts_at and ends_at dates/times for the ACS user's access
user_identity_id	ID of the user identity associated with the ACS user
user_identity_full_name	Full name of the user identity associated with the ACS user
user_identity_email_address	Email address of the user identity associated with the ACS user
user_identity_phone_number	Phone number of the user identity associated with the ACS user in E.164 format (for example, [phone])

Sample Response

Python

[
  AcsUser(
    acs_user_id="33333333-3333-3333-3333-333333333333',
    display_name='Jane Doe',
    full_name='Jane Doe',
    email='[email protected]',
    email_address='[email protected]',
    phone_number='[phone]',
    acs_system_id='11111111-1111-1111-1111-111111111111',
    workspace_id='00000000-0000-0000-0000-000000000000",
    created_at='2024-04-05T07:14:28.531Z',
    is_suspended=False,
    access_schedule={
      'starts_at': '2024-03-01T10:40:00.000Z',
      'ends_at': '2024-03-04T10:40:00.000Z'
    },
    user_identity_id='22222222-2222-2222-2222-222222222222',
    user_identity_full_name='Jane Doe',
    user_identity_email_address='[email protected]',
    user_identity_phone_number='[phone]'
  ),
  ...
]

cURL (bash)

JavaScript

Ruby

PHP

C#

Java

Go