List ACS Systems Associated with a User Identity

Get all access control systems associated with a specified user identity

Returns a list of all access control systems associated with a user identity.

/user_identities/list_acs_systems

post

Returns a list of all access systems associated with a specified user identity.

Authorizations

client_sessionpat_with_workspaceconsole_session_with_workspaceapi_key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

user_identity_idstring · uuidRequired

ID of the user identity for which you want to retrieve all access systems.

Responses

200

OK

application/json

400

Bad Request

401

Unauthorized

post

/user_identities/list_acs_systems

HTTPcURLJavaScriptPython

POST /user_identities/list_acs_systems HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

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

{
  "acs_systems": [
    {
      "default_credential_manager_acs_system_id": "123e4567-e89b-12d3-a456-426614174000",
      "acs_system_id": "123e4567-e89b-12d3-a456-426614174000",
      "acs_user_count": 1,
      "acs_access_group_count": 1,
      "external_type": "pti_site",
      "external_type_display_name": "text",
      "is_credential_manager": true,
      "visionline_metadata": {
        "mobile_access_uuid": "text",
        "system_id": "text",
        "lan_address": "text"
      },
      "location": {
        "time_zone": "text"
      },
      "name": "text",
      "created_at": "2025-12-16T20:48:40.886Z",
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
      "image_url": "text",
      "image_alt_text": "text",
      "errors": [
        {
          "created_at": "2025-12-16T20:48:40.886Z",
          "message": "text",
          "error_code": "seam_bridge_disconnected"
        }
      ],
      "warnings": [
        {
          "created_at": "2025-12-16T20:48:40.886Z",
          "message": "text",
          "warning_code": "salto_ks_subscription_limit_almost_reached"
        }
      ]
    }
  ],
  "ok": true
}

Request

Specify the user identity for which you want to retrieve all associated access control systems by including the corresponding user_identity_id in the request body.

Request Body Parameters

Parameter	Type	Description
user_identity_id	String Required	ID of the user identity for which you want to retrieve all access control systems

Sample Request

cURL (bash)

# Use GET or POST.
curl -X 'GET' \
  'https://connect.getseam.com/user_identities/list_acs_systems' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer ${API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "user_identity_id": "5c945ab5-c75e-4bcb-8e5f-9410061c401f"
}'

Go

Response

Returns an acs_systems array, in which each returned access control system (acs_system) contains the following properties:

Property	Description
acs_system_id	ID of the access control system
external_type	Brand-specific terminology for the access control system type
external_type_display_name	Display name that corresponds to the brand-specific terminology for the access control system type
name	Name of the access control system
created_at	Date and time at which the access control system was created
workspace_id	ID of the workspace that contains the access control system
connected_account_ids	Array of connected account IDs associated with the access control system

This response also includes a Boolean ok status indicator.

Sample Response

JSON

{
  "acs_systems": [
    {
      "acs_system_id": "6737e186-8d54-48ce-a7da-a0be4d252172",
      "name": "Assa Abloy Credential Service",
      "workspace_id": "398d80b7-3f96-47c2-b85a-6f8ba21d07be",
      "created_at": "2024-01-05T07:16:51.971Z",
      "system_type": "assa_abloy_credential_service",
      "system_type_display_name": "Assa Abloy Credential Service",
      "external_type": "assa_abloy_credential_service",
      "external_type_display_name": "Assa Abloy Credential Service",
      "connected_account_ids": [
        "dc08066f-d9b8-42f0-9c4b-c781cd900153"
      ]
    }
  ],
  "ok": true
}