---
title: "Get an ACS System"
method: POST
path: "/acs/systems/get"
tags: ["/acs"]
---

# Get an ACS System

`POST /acs/systems/get`

Returns a specified [access system](/low-level-apis/access-systems).

## Request body

- object
  - `acs_system_id` string, uuid, required — ID of the access system that you want to get.

## Response `200`

OK

- object
  - `acs_system` AcsSystem, required — Represents an [access control system](/low-level-apis/access-systems). Within an `acs_system`, create [`acs_user`s](/api/acs/users/object) and [`acs_credential`s](/api/acs/credentials/object) to grant access to the `acs_user`s. For details about the resources associated with an access control system, see the [access control systems namespace](/api/acs/object). See the [acs_system object](/api/acs/systems/object).
    - `acs_access_group_count` number, float — Number of access groups in the [access control system](/low-level-apis/access-systems).
    - `acs_system_id` string, uuid, required — ID of the [access control system](/low-level-apis/access-systems).
    - `acs_user_count` number, float — Number of users in the [access control system](/low-level-apis/access-systems).
    - `connected_account_id` string, uuid, required — ID of the connected account associated with the [access control system](/low-level-apis/access-systems).
    - `connected_account_ids` string[], required — Deprecated. Use `connected_account_id`. IDs of the [connected accounts](/core-concepts/connected-accounts) associated with the [access control system](/low-level-apis/access-systems).
    - `created_at` string, date-time, required — Date and time at which the [access control system](/low-level-apis/access-systems) was created.
    - `default_credential_manager_acs_system_id` string, uuid, nullable — ID of the default credential manager `acs_system` for this [access control system](/low-level-apis/access-systems).
    - `errors` object[], required — Errors associated with the [access control system](/low-level-apis/access-systems).
      - `error_code` string — Error or warning code.
      - `message` string — Human-readable description.
      - `created_at` string, date-time — When this error or warning was generated.
    - `external_type` 'pti_site' | 'avigilon_alta_org' | 'salto_ks_site' | 'salto_space_system' | 'brivo_account' | 'hid_credential_manager_organization' | 'visionline_system' | 'assa_abloy_credential_service' | 'latch_building' | 'dormakaba_community_site' | 'dormakaba_ambiance_site' | 'legic_connect_credential_service' | 'assa_abloy_vostio' | 'assa_abloy_vostio_credential_service' | 'hotek_site' | 'kisi_organization' — Brand-specific terminology for the [access control system](/low-level-apis/access-systems) type.
    - `external_type_display_name` string — Display name that corresponds to the brand-specific terminology for the [access control system](/low-level-apis/access-systems) type.
    - `image_alt_text` string, required — Alternative text for the [access control system](/low-level-apis/access-systems) image.
    - `image_url` string, required — URL for the image that represents the [access control system](/low-level-apis/access-systems).
    - `is_credential_manager` boolean, required — Indicates whether the `acs_system` is a credential manager.
    - `location` object, required — Location information for the [access control system](/low-level-apis/access-systems).
      - `time_zone` string, nullable, required — Time zone in which the [access control system](/low-level-apis/access-systems) is located.
    - `name` string, required — Name of the [access control system](/low-level-apis/access-systems).
    - `system_type` 'pti_site' | 'avigilon_alta_org' | 'salto_ks_site' | 'salto_space_system' | 'brivo_account' | 'hid_credential_manager_organization' | 'visionline_system' | 'assa_abloy_credential_service' | 'latch_building' | 'dormakaba_community_site' | 'dormakaba_ambiance_site' | 'legic_connect_credential_service' | 'assa_abloy_vostio' | 'assa_abloy_vostio_credential_service' | 'hotek_site' | 'kisi_organization' — Deprecated. Use `external_type`.
    - `system_type_display_name` string — Deprecated. Use `external_type_display_name`.
    - `visionline_metadata` object — Visionline-specific metadata for the [access control system](/low-level-apis/access-systems).
      - `lan_address` string — IP address or hostname of the main Visionline server relative to [Seam Bridge](/capability-guides/seam-bridge) on the local network.
      - `mobile_access_uuid` string — Keyset loaded into a reader. Mobile keys and reader administration tools securely authenticate only with readers programmed with a matching keyset.
      - `system_id` string — Unique ID assigned by the ASSA ABLOY licensing team that identifies each hotel in your credential manager.
    - `warnings` union[], required — Warnings associated with the [access control system](/low-level-apis/access-systems).
      - union — Warning associated with the [access control system](/low-level-apis/access-systems).
        - object — Indicates that the Salto KS site has exceeded 80% of the maximum number of allowed users. Increase your subscription limit or delete some users from your site to rectify the issue.
          - `created_at` string, date-time, required — Date and time at which Seam created the warning.
          - `message` string, required — Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
          - `warning_code` 'salto_ks_subscription_limit_almost_reached', required — Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
        - object — Indicates the [access control system](/low-level-apis/access-systems) time zone could not be determined because the reported physical location does not match the time zone configured on the physical [ACS entrances](/low-level-apis/access-systems/retrieving-entrance-details).
          - `created_at` string, date-time, required — Date and time at which Seam created the warning.
          - `message` string, required — Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
          - `misconfigured_acs_entrance_ids` string[] — Deprecated. this field is deprecated.
          - `warning_code` 'time_zone_does_not_match_location', required — Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
        - object — Indicates that the access control system requires additional setup before it can be fully operational. Follow the instructions in the warning message to complete the setup.
          - `created_at` string, date-time, required — Date and time at which Seam created the warning.
          - `message` string, required — Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
          - `warning_code` 'setup_required', required — Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
    - `workspace_id` string, uuid, required — ID of the workspace that contains the [access control system](/low-level-apis/access-systems).

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/seam/apis/seam-connect.md) · [All operations](https://skmtc.net/seam/apis/seam-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/seam/seam-connect/versions/00c35395ce12/schema)