> ## 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 Entrance Details

> Learn how to get details about the entrances in your ACS, including listing the credentials that provide access to a specific entrance.

In an ACS, an entrance is a secured door, gate, zone, or other method of entry. You can list details for all the `acs_entrance` resources in your [workspace](/core-concepts/workspaces/index) or get these details for a specific `acs_entrance`. You can also list all entrances associated with a specific [credential](/low-level-apis/access-systems/managing-credentials), and you can list all credentials associated with a specific entrance.

***

## List All Entrances

You can [list all `acs_entrance` resources](/api/acs/entrances/list) in your workspace. Note that entrance details include manufacturer-specific metadata that may vary by [manufacturer](/device-and-system-integration-guides#access-control-systems).

**Request:**

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

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

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

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

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

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

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  [
    {
      acs_entrance_id: '55555555-5555-5555-5555-555555555555',
      acs_system_id: '11111111-1111-1111-1111-111111111111',
      workspace_id: '00000000-0000-0000-0000-000000000000',
      display_name: 'Guest Lock 2',
      ...
    },
    ...
  ]
  ```

  ```json cURL theme={null}
  {
    "acs_entrances": [
      {
        "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
        "acs_system_id": "11111111-1111-1111-1111-111111111111",
        "workspace_id": "00000000-0000-0000-0000-000000000000",
        "display_name": "Guest Lock 2",
        ...
      },
      ...
    ],
    "ok": true
  }
  ```

  ```json Python theme={null}
  [
    AcsEntrance(
      acs_entrance_id='55555555-5555-5555-5555-555555555555',
      acs_system_id='11111111-1111-1111-1111-111111111111',
      workspace_id='00000000-0000-0000-0000-000000000000',
      display_name='Guest Lock 2',
      ....
    ),
    ...
  ]
  ```

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

  ```json PHP theme={null}
  [
    {
      "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
      "acs_system_id": "11111111-1111-1111-1111-111111111111",
      "workspace_id": "00000000-0000-0000-0000-000000000000",
      "display_name": "Guest Lock 2",
      ...
    },
    ...
  ]
  ```

  ```json C# theme={null}
  {
    "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "workspace_id": "00000000-0000-0000-0000-000000000000",
    "display_name": "Guest Lock 2",
    ...
  }
  ...
  ```
</CodeGroup>

***

## List Entrances in an ACS

To list all `acs_entrance`s in a specific ACS, include the `acs_system_id` filter in the [List Entrances](/api/acs/entrances/list) request. Note that entrance details include manufacturer-specific metadata that may vary by [manufacturer](/device-and-system-integration-guides#access-control-systems).

**Request:**

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

  ```bash cURL theme={null}
  # Use GET or POST.
  curl -X 'GET' \
    'https://connect.getseam.com/acs/entrances/list' \
    -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.entrances.list(
    acs_system_id="11111111-1111-1111-1111-111111111111"
  )
  ```

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

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

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

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  [
    {
      acs_entrance_id: '55555555-5555-5555-5555-555555555555',
      acs_system_id: '11111111-1111-1111-1111-111111111111',
      workspace_id: '00000000-0000-0000-0000-000000000000',
      display_name: 'Guest Lock 2',
      ...
    },
    ...
  ]
  ```

  ```json cURL theme={null}
  {
    "acs_entrances": [
      {
        "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
        "acs_system_id": "11111111-1111-1111-1111-111111111111",
        "workspace_id": "00000000-0000-0000-0000-000000000000",
        "display_name": "Guest Lock 2",
        ...
      },
      ...
    ],
    "ok": true
  }
  ```

  ```json Python theme={null}
  [
    AcsEntrance(
      acs_entrance_id='55555555-5555-5555-5555-555555555555',
      acs_system_id='11111111-1111-1111-1111-111111111111',
      workspace_id='00000000-0000-0000-0000-000000000000',
      display_name='Guest Lock 2',
      ....
    ),
    ...
  ]
  ```

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

  ```json PHP theme={null}
  [
    {
      "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
      "acs_system_id": "11111111-1111-1111-1111-111111111111",
      "workspace_id": "00000000-0000-0000-0000-000000000000",
      "display_name": "Guest Lock 2",
      ...
    },
    ...
  ]
  ```

  ```json C# theme={null}
  {
    "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "workspace_id": "00000000-0000-0000-0000-000000000000",
    "display_name": "Guest Lock 2",
    ...
  }
  ...
  ```
</CodeGroup>

***

## List Credentials Associated with an Entrance

To [list the credentials that grant access to a specific entrance](/api/acs/entrances/list_credentials_with_access), use `list_credentials_with_access` method for the `acs_entrance` object and provide the `acs_entrance_id`.

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.acs.entrances.list_credentials_with_access({
    acs_entrance_id: '55555555-5555-5555-5555-555555555555',
  })
  ```

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

  ```python Python theme={null}
  seam.acs.entrances.list_credentials_with_access(
    acs_entrance_id="55555555-5555-5555-5555-555555555555"
  )
  ```

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

  ```php PHP theme={null}
  $seam->acs->entrances->list_credentials_with_access(
    acs_entrance_id: "55555555-5555-5555-5555-555555555555"
  );
  ```

  ```csharp C# theme={null}
  seam.EntrancesAcs.ListCredentialsWithAccess(
    acsEntranceId: "55555555-5555-5555-5555-555555555555"
  );
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  [
    {
      acs_credential_id: '77777777-7777-7777-7777-777777777777',
      acs_user_id: '33333333-3333-3333-3333-333333333333',
      acs_system_id: '11111111-1111-1111-1111-111111111111',
      access_method: 'mobile_key',
      starts_at: '2024-04-09T14:30:55.688Z',
      ends_at: '2024-03-04T10:40:00.000Z',
      ...
    },
    ...
  ]
  ```

  ```json cURL theme={null}
  {
    "acs_credentials": [
      {
        "acs_credential_id": "77777777-7777-7777-7777-777777777777",
        "acs_user_id": "33333333-3333-3333-3333-333333333333",
        "acs_system_id": "11111111-1111-1111-1111-111111111111",
        "access_method": "mobile_key",
        "starts_at": "2024-04-09T14:30:55.688Z",
        "ends_at": "2024-03-04T10:40:00.000Z",
        ...
      },
      ...
    ],
    "ok": true
  }
  ```

  ```json Python theme={null}
  [
    AcsCredential(
      acs_credential_id='77777777-7777-7777-7777-777777777777',
      acs_user_id='33333333-3333-3333-3333-333333333333',
      acs_system_id='11111111-1111-1111-1111-111111111111',
      access_method='mobile_key',
      starts_at='2024-04-09T14:30:55.688Z',
      ends_at='2024-03-04T10:40:00.000Z',
      ...
    ),
    ...
  ]
  ```

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

  ```json PHP theme={null}
  [
    {
      "acs_credential_id": "77777777-7777-7777-7777-777777777777",
      "acs_user_id": "33333333-3333-3333-3333-333333333333",
      "acs_system_id": "11111111-1111-1111-1111-111111111111",
      "access_method": "mobile_key",
      "starts_at": "2024-04-09T14:30:55.688Z",
      "ends_at": "2024-03-04T10:40:00.000Z",
      ...
    },
    ...
  ]
  ```

  ```json C# theme={null}
  {
    "acs_credential_id": "77777777-7777-7777-7777-777777777777",
    "acs_user_id": "33333333-3333-3333-3333-333333333333",
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "access_method": "mobile_key",
    "starts_at": "2024-04-09T14:30:55.688Z",
    "ends_at": "2024-03-04T10:40:00.000Z",
    ...
  }
  ...
  ```
</CodeGroup>

***

## List Entrances Associated with a Credential

To [list the entrances to which a specific credential grants access](/api/acs/credentials/list_accessible_entrances), use `list_accessible_entrances` method for the `acs_credential` object and provide the `acs_credential_id`. For details, see [Managing Credentials](/low-level-apis/access-systems/managing-credentials/listing-credentials-and-associated-entrances#list-entrances-associated-with-a-credential).

***

## Get an Entrance

You can [get the details of a specific `acs_entrance`](/api/acs/entrances/get). Note that entrance details include manufacturer-specific metadata that may vary by [manufacturer](/device-and-system-integration-guides#access-control-systems).

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.acs.entrances.get({
    acs_entrance_id: '55555555-5555-5555-5555-555555555555',
  })
  ```

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

  ```python Python theme={null}
  seam.acs.entrances.get(
    acs_entrance_id="55555555-5555-5555-5555-555555555555"
  )
  ```

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

  ```php PHP theme={null}
  $seam->acs->entrances->get(
    acs_entrance_id: "55555555-5555-5555-5555-555555555555"
  );
  ```

  ```csharp C# theme={null}
  seam.EntrancesAcs.Get(
    acsEntranceId: "55555555-5555-5555-5555-555555555555"
  );
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  {
    acs_entrance_id: '55555555-5555-5555-5555-555555555555',
    acs_system_id: '11111111-1111-1111-1111-111111111111',
    workspace_id: '00000000-0000-0000-0000-000000000000',
    display_name: 'Guest Lock 2',
    ...
  }
  ```

  ```json cURL theme={null}
  {
    "acs_entrance": {
      "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
      "acs_system_id": "11111111-1111-1111-1111-111111111111",
      "workspace_id": "00000000-0000-0000-0000-000000000000",
      "display_name": "Guest Lock 2",
      ...
    },
    "ok": true
  }
  ```

  ```json Python theme={null}
  AcsEntrance(
    acs_entrance_id: '55555555-5555-5555-5555-555555555555',
    acs_system_id: '11111111-1111-1111-1111-111111111111',
    workspace_id: '00000000-0000-0000-0000-000000000000',
    display_name: 'Guest Lock 2',
    ...
  )
  ```

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

  ```json PHP theme={null}
  {
    "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "workspace_id": "00000000-0000-0000-0000-000000000000",
    "display_name": "Guest Lock 2",
    ...
  }
  ```

  ```json C# theme={null}
  {
    "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "workspace_id": "00000000-0000-0000-0000-000000000000",
    "display_name": "Guest Lock 2",
    ...
  }
  ```
</CodeGroup>