> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seam.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieving ACS System Details

> Learn how to list and get information about your ACS systems.

You can list details for all the ACSs in your [workspace](/core-concepts/workspaces/index) or get these details for a specific ACS. Note that Seam represents the ACS as an [`acs_system`](/api/acs/systems/object) resource. When you want to [create ACS users](/low-level-apis/access-systems/user-management#create-an-acs-user) for your ACS, you must first obtain the ID of the `acs_system` for which you want to create these users.

***

## List ACS Systems

You can [list all `acs_system` resources](/api/acs/systems/list) in your workspace. Note the `acs_system_id` in the response.

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.acs.systems.list()
  ```

  ```bash cURL theme={null}
  # Use GET or POST.
  curl -X 'GET' \
    'https://connect.getseam.com/acs/systems/list' \
    -H 'accept: application/json' \
    -H "Authorization: Bearer ${API_KEY}" \
    -H 'Content-Type: application/json' \
    -d '{}'
  ```

  ```python Python theme={null}
  seam.acs.systems.list()
  ```

  ```ruby Ruby theme={null}
  # Coming soon!
  ```

  ```php PHP theme={null}
  $seam->acs->systems->list();
  ```

  ```csharp C# theme={null}
  seam.SystemsAcs.List();
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  [
    {
      acs_system_id: '11111111-1111-1111-1111-111111111111',
      name: 'Visionline System',
      ...
    },
    ...
  ]
  ```

  ```json cURL theme={null}
  {
    "acs_systems": [
      {
        "acs_system_id": "11111111-1111-1111-1111-111111111111",
        "name": "Visionline System",
        ...
      },
      ...
    ],
    "ok": true
  }
  ```

  ```json Python theme={null}
  [
    AcsSystem(
      acs_system_id='11111111-1111-1111-1111-111111111111',
      name='Visionline System',
      ...
    ),
    ...
  ]
  ```

  ```json Ruby theme={null}
  # Coming soon!
  ```

  ```json PHP theme={null}
  [
    {
      "acs_system_id": "11111111-1111-1111-1111-111111111111",
      "name": "Visionline System",
      ...
    },
    ...
  ]
  ```

  ```json C# theme={null}
  {
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "name": "Visionline System",
    ...
  }
  ...
  ```
</CodeGroup>

***

## Get an ACS System

You can [get the details of a specific `acs_system`](/api/acs/systems/get) in your workspace. These details include the `acs_system_id`, date and time at which the `acs_system` was created in Seam, the name and type of the `acs_system`, and so on.

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.acs.systems.get({
    acs_system_id: '11111111-1111-1111-1111-111111111111',
  })
  ```

  ```bash cURL theme={null}
  # Use GET or POST.
  curl -X 'GET' \
    'https://connect.getseam.com/acs/systems/get' \
    -H 'accept: application/json' \
    -H "Authorization: Bearer ${API_KEY}" \
    -H 'Content-Type: application/json' \
    -d '{
    "acs_system_id": "11111111-1111-1111-1111-111111111111"
  }'
  ```

  ```python Python theme={null}
  seam.acs.systems.get(
   acs_system_id="11111111-1111-1111-1111-111111111111"
  )
  ```

  ```ruby Ruby theme={null}
  # Coming soon!
  ```

  ```php PHP theme={null}
  $seam->acs->systems->get(
    acs_system_id: "11111111-1111-1111-1111-111111111111"
  );
  ```

  ```csharp C# theme={null}
  seam.SystemsAcs.Get(
    acsSystemId: "11111111-1111-1111-1111-111111111111"
  );
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  {
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "name": "Example Inc",
    "workspace_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2023-11-30T06:27:14.961Z",
    "external_type": "pti_site",
    "external_type_display_name": "PTI site",
    "connected_account_ids": ["11111111-1111-1111-1111-222222222222"],
    "image_url": "https://connect.getseam.com/assets/images/acs_systems/pti_site.png",
    "image_alt_text": "PTI site Logo"
  }
  ```

  ```json cURL theme={null}
  {
    "acs_system": {
      "acs_system_id": "11111111-1111-1111-1111-111111111111",
      "name": "Example Inc",
      "workspace_id": "00000000-0000-0000-0000-000000000000",
      "created_at": "2023-11-30T06:27:14.961Z",
      "external_type": "pti_site",
      "external_type_display_name": "PTI site",
      "connected_account_ids": ["11111111-1111-1111-1111-222222222222"],
      "image_url": "https://connect.getseam.com/assets/images/acs_systems/pti_site.png",
      "image_alt_text": "PTI site Logo"
    },
    "ok": true
  }
  ```

  ```json Python theme={null}
  AcsSystem(
    acs_system_id='11111111-1111-1111-1111-111111111111',
    name='Example Inc',
    workspace_id='00000000-0000-0000-0000-000000000000',
    created_at='2023-11-30T06:27:14.961Z',
    external_type='pti_site',
    external_type_display_name='PTI site",
    connected_account_ids=[
      '11111111-1111-1111-1111-222222222222'
    ],
    image_url='https://connect.getseam.com/assets/images/acs_systems/pti_site.png',
    image_alt_text='PTI site Logo'
  )
  ```

  ```json Ruby theme={null}
  # Coming soon!
  ```

  ```json PHP theme={null}
  {
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "name": "Example Inc",
    "workspace_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2023-11-30T06:27:14.961Z",
    "external_type": "pti_site",
    "external_type_display_name": "PTI site",
    "connected_account_ids": ["11111111-1111-1111-1111-222222222222"],
    "image_url": "https://connect.getseam.com/assets/images/acs_systems/pti_site.png",
    "image_alt_text": "PTI site Logo"
  }
  ```

  ```json C# theme={null}
  {
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "name": "Example Inc",
    "workspace_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2023-11-30T06:27:14.961Z",
    "external_type": "pti_site",
    "external_type_display_name": "PTI site",
    "connected_account_ids": ["11111111-1111-1111-1111-222222222222"],
    "image_url": "https://connect.getseam.com/assets/images/acs_systems/pti_site.png",
    "image_alt_text": "PTI site Logo"
  }
  ```
</CodeGroup>