Listing Credentials and Associated Entrances

Learn how to list entrances associated with a credential and credentials associated with an entrance.

Once you have created credentials, you can retrieve the set of entrances associated with a credential. You can also use an acs_entrance endpoint to retrieve the credentials that grant access to a specific entrance.

List Entrances Associated with a Credential

To list the entrances to which a specific credential grants access, use list_accessible_entrances and provide the acs_credential_id.

Python

Request:

seam.acs.credentials.list_accessible_entrances(
  acs_credential_id="66666666-6666-6666-6666-666666666666"
)

Response:

This response contains manufacturer-specific metadata that may vary by manufacturer.

[
  AcsEntrance(
    acs_entrance_id='55555555-5555-5555-5555-555555555555',
    acs_system_id='11111111-1111-1111-1111-111111111111',
    display_name='Guest Lock 2',
    ...
  ),
  ...
]

cURL (bash)

Request:

# Use GET or POST.
curl -X 'GET' \
  'https://connect.getseam.com/acs/credentials/list_accessible_entrances' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer ${API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
  "acs_credential_id": "66666666-6666-6666-6666-666666666666"
}'

Response:

This response contains manufacturer-specific metadata that may vary by manufacturer.

{
  "acs_entrances": [
    {
      "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
      "acs_system_id": "11111111-1111-1111-1111-111111111111",
      "display_name": "Guest Lock 2",
      ...
    },
    ...
  ],
  "ok": true
}

JavaScript

Request:

await seam.acs.credentials.listAccessibleEntrances({
  acs_credential_id: "66666666-6666-6666-6666-666666666666"
});

Response:

This response contains manufacturer-specific metadata that may vary by manufacturer.

[
  {
    acs_entrance_id: '55555555-5555-5555-5555-555555555555',
    acs_system_id: '11111111-1111-1111-1111-111111111111',
    display_name: 'Guest Lock 2',
    ...
  },
  ...
]

Ruby

Request:

# Coming soon!

Response:

# Coming soon!

PHP

Request:

$seam->acs->credentials->list_accessible_entrances(
  acs_credential_id: "66666666-6666-6666-6666-666666666666"
);

Response:

This response contains manufacturer-specific metadata that may vary by manufacturer.

[
  {
    "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "display_name": "Guest Lock 2",
    ...
  },
  ...
]

C#

Request:

seam.CredentialsAcs.ListAccessibleEntrances(
  acsCredentialId: "66666666-6666-6666-6666-666666666666"
);

Response:

This response contains manufacturer-specific metadata that may vary by manufacturer.

{
  "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
  "acs_system_id": "11111111-1111-1111-1111-111111111111",
  "display_name": "Guest Lock 2",
  ...
}
...

Java

Request:

// Coming soon!

Response:

// Coming soon!

Go

Request:

acs_entrances, uErr := client.Acs.Credentials.ListAccessibleEntrances(
  context.Background(), &acs.CredentialsListAccessibleEntrancesRequest{
    AcsCredentialId: "66666666-6666-6666-6666-666666666666",
  },
)

Response:

This response contains manufacturer-specific metadata that may vary by manufacturer.

[
  {
    "acs_entrance_id": "55555555-5555-5555-5555-555555555555",
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "display_name": "Guest Lock 2",
    ...
  },
  ...
]

---

List Credentials Associated with an Entrance

To list the credentials that grant access to a specific entrance, use list_credentials_with_access method for the acs_entrance object and provide the acs_entrance_id. For details, see Retrieving Entrance Details.