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

POSThttps://connect.getseam.com/user_identities/list_acs_systems

Authorization

client_sessionpat_with_workspaceconsole_sessionapi_key

Body

application/json

user_identity_id*string (uuid)

Response

200400401

OK

Body

application/json

acs_systems*array of acs_system (object)

ok*boolean

Request

JavaScriptCurlPython

const response = await fetch('https://connect.getseam.com/user_identities/list_acs_systems', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer Client Session Token",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "user_identity_id": "123e4567-e89b-12d3-a456-426614174000"
    }),
});
const data = await response.json();

Response

200

{
  "acs_systems": [
    {
      "acs_system_id": "123e4567-e89b-12d3-a456-426614174000",
      "external_type": "pti_site",
      "external_type_display_name": "text",
      "visionline_metadata": {
        "mobile_access_uuid": "text",
        "system_id": "text",
        "lan_address": "text"
      },
      "name": "text",
      "created_at": "2024-09-19T18:44:33.646Z",
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "connected_account_ids": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "image_url": "text",
      "image_alt_text": "text",
      "errors": [
        {
          "created_at": "2024-09-19T18:44:33.646Z",
          "message": "text",
          "error_code": "seam_bridge_disconnected"
        }
      ],
      "warnings": [
        {
          "created_at": "2024-09-19T18:44:33.646Z",
          "message": "text",
          "warning_code": "salto_ks_subscription_limit_almost_reached"
        }
      ],
      "can_automate_enrollment": false,
      "can_create_acs_access_groups": false,
      "can_remove_acs_users_from_acs_access_groups": false,
      "can_add_acs_users_to_acs_access_groups": false
    }
  ],
  "ok": false
}

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

acsSystems, uErr := client.UserIdentities.ListAcsSystems(context.Background(), &useridentities.UserIdentitiesListAcsSystemsRequest{
    UserIdentityId: "48500a8e-5e7e-4bde-b7e5-0be97cae5d7a",
})

if uErr != nil {
    return uErr
}

fmt.Println(acsSystems)
return nil

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
}