> ## 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. # List Credentials with Access to an Entrance > Returns a list of all [credentials](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) with access to a specified [entrance](https://docs.seam.co/low-level-apis/access-systems/retrieving-entrance-details). ## OpenAPI ````yaml /openapi.json post /acs/entrances/list_credentials_with_access openapi: 3.0.0 info: title: Seam Connect version: 1.0.0 servers: - url: https://connect.getseam.com security: [] tags: - description: access_codes name: /access_codes - description: acs name: /acs - description: action_attempts name: /action_attempts - description: client_sessions name: /client_sessions - description: connected_accounts name: /connected_accounts - description: connect_webviews name: /connect_webviews - description: devices name: /devices - description: events name: /events - description: health name: /health - description: locks name: /locks - description: networks name: /networks - description: noise_sensors name: /noise_sensors - description: phones name: /phones - description: thermostats name: /thermostats - description: user_identities name: /user_identities - description: webhooks name: /webhooks - description: workspaces name: /workspaces paths: /acs/entrances/list_credentials_with_access: post: tags: - /acs summary: List Credentials with Access to an Entrance description: >- Returns a list of all [credentials](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) with access to a specified [entrance](https://docs.seam.co/low-level-apis/access-systems/retrieving-entrance-details). operationId: acsEntrancesListCredentialsWithAccessPost requestBody: content: application/json: schema: properties: acs_entrance_id: description: >- ID of the entrance for which you want to list all credentials that grant access. format: uuid type: string include_if: description: >- Conditions that credentials must meet to be included in the returned list. items: enum: - visionline_metadata.is_valid type: string type: array required: - acs_entrance_id type: object responses: '200': content: application/json: schema: properties: acs_credentials: items: $ref: '#/components/schemas/acs_credential' type: array ok: type: boolean required: - acs_credentials - ok type: object description: OK '400': description: Bad Request '401': description: Unauthorized security: - client_session: [] - pat_with_workspace: [] - console_session_with_workspace: [] - api_key: [] x-codeSamples: - lang: javascript label: Seam SDK source: |- await seam.acs.entrances.listCredentialsWithAccess({ acs_entrance_id: "afdde789-8684-425a-b421-6031bb3df62e", }); /* [ { "access_method": "code", "acs_credential_id": "73a0a199-024f-454d-a916-9bbda8502c12", "acs_system_id": "b1d03165-2759-474b-a342-e02223f27b39", "acs_user_id": "0fc82df4-391b-4d00-a234-86378f1c3952", "code": "123456", "created_at": "2025-06-16T16:54:17.946514Z", "display_name": "FRONT_DOOR", "errors": [], "external_type": "salto_ks_credential", "external_type_display_name": "Salto KS Credential", "is_latest_desired_state_synced_with_provider": true, "is_managed": true, "is_multi_phone_sync_credential": false, "is_one_time_use": false, "latest_desired_state_synced_with_provider_at": "2025-06-18T16:54:17.946514Z", "starts_at": "2025-07-10T16:54:17.946512Z", "warnings": [], "workspace_id": "005f1e54-5360-40db-8c31-4ef6baaad1fd" } ] */ - lang: bash label: cURL source: >- curl --include --request POST "https://connect.getseam.com/acs/entrances/list_credentials_with_access" \ --header "Authorization: Bearer $SEAM_API_KEY" \ --json @- < [ { "access_method" => "code", "acs_credential_id" => "73a0a199-024f-454d-a916-9bbda8502c12", "acs_system_id" => "b1d03165-2759-474b-a342-e02223f27b39", "acs_user_id" => "0fc82df4-391b-4d00-a234-86378f1c3952", "code" => "123456", "created_at" => "2025-06-16T16:54:17.946514Z", "display_name" => "FRONT_DOOR", "errors" => [], "external_type" => "salto_ks_credential", "external_type_display_name" => "Salto KS Credential", "is_latest_desired_state_synced_with_provider" => true, "is_managed" => true, "is_multi_phone_sync_credential" => false, "is_one_time_use" => false, "latest_desired_state_synced_with_provider_at" => "2025-06-18T16:54:17.946514Z", "starts_at" => "2025-07-10T16:54:17.946512Z", "warnings" => [], "workspace_id" => "005f1e54-5360-40db-8c31-4ef6baaad1fd", }, ] - lang: php label: Seam SDK source: |- $seam->acs->entrances->list_credentials_with_access( acs_entrance_id: "afdde789-8684-425a-b421-6031bb3df62e", ); // [ [ "access_method" => "code", "acs_credential_id" => "73a0a199-024f-454d-a916-9bbda8502c12", "acs_system_id" => "b1d03165-2759-474b-a342-e02223f27b39", "acs_user_id" => "0fc82df4-391b-4d00-a234-86378f1c3952", "code" => "123456", "created_at" => "2025-06-16T16:54:17.946514Z", "display_name" => "FRONT_DOOR", "errors" => [], "external_type" => "salto_ks_credential", "external_type_display_name" => "Salto KS Credential", "is_latest_desired_state_synced_with_provider" => true, "is_managed" => true, "is_multi_phone_sync_credential" => false, "is_one_time_use" => false, "latest_desired_state_synced_with_provider_at" => "2025-06-18T16:54:17.946514Z", "starts_at" => "2025-07-10T16:54:17.946512Z", "warnings" => [], "workspace_id" => "005f1e54-5360-40db-8c31-4ef6baaad1fd", ], ]; - lang: bash label: Seam CLI source: >- seam acs entrances list-credentials-with-access --acs_entrance_id "afdde789-8684-425a-b421-6031bb3df62e" # [ # { # "access_method": "code", # "acs_credential_id": "73a0a199-024f-454d-a916-9bbda8502c12", # "acs_system_id": "b1d03165-2759-474b-a342-e02223f27b39", # "acs_user_id": "0fc82df4-391b-4d00-a234-86378f1c3952", # "code": "123456", # "created_at": "2025-06-16T16:54:17.946514Z", # "display_name": "FRONT_DOOR", # "errors": [], # "external_type": "salto_ks_credential", # "external_type_display_name": "Salto KS Credential", # "is_latest_desired_state_synced_with_provider": true, # "is_managed": true, # "is_multi_phone_sync_credential": false, # "is_one_time_use": false, # "latest_desired_state_synced_with_provider_at": "2025-06-18T16:54:17.946514Z", # "starts_at": "2025-07-10T16:54:17.946512Z", # "warnings": [], # "workspace_id": "005f1e54-5360-40db-8c31-4ef6baaad1fd" # } # ] components: schemas: acs_credential: description: >- Means by which an [access control system user](https://docs.seam.co/low-level-apis/access-systems/user-management) gains access at an [entrance](https://docs.seam.co/low-level-apis/access-systems/retrieving-entrance-details). The `acs_credential` object represents a [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) that provides an ACS user access within an [access control system](https://docs.seam.co/low-level-apis/access-systems). properties: access_method: description: >- Access method for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials). Supported values: `code`, `card`, `mobile_key`, `cloud_key`. enum: - code - card - mobile_key - cloud_key type: string acs_credential_id: description: >- ID of the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials). format: uuid type: string acs_credential_pool_id: format: uuid type: string acs_system_id: description: >- ID of the [access control system](https://docs.seam.co/low-level-apis/access-systems) that contains the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials). format: uuid type: string acs_user_id: description: >- ID of the [ACS user](https://docs.seam.co/low-level-apis/access-systems/user-management) to whom the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) belongs. format: uuid type: string assa_abloy_vostio_metadata: description: >- Vostio-specific metadata for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials). properties: auto_join: description: >- Indicates whether the credential should auto-join. For an auto-join credential, Seam automatically issues an override card if there are no other cards and a joiner card if there are existing cards on the doors. type: boolean door_names: description: >- Names of the doors to which to grant access in the Vostio access system. items: type: string type: array endpoint_id: description: Endpoint ID in the Vostio access system. type: string key_id: description: Key ID in the Vostio access system. type: string key_issuing_request_id: description: Key issuing request ID in the Vostio access system. type: string override_guest_acs_entrance_ids: description: >- IDs of the guest entrances to override in the Vostio access system. items: type: string type: array type: object card_number: description: >- Number of the card associated with the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials). nullable: true type: string code: description: >- Access (PIN) code for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials). nullable: true type: string connected_account_id: description: >- ID of the [connected account](https://docs.seam.co/low-level-apis/access-systems/managing-credentials#connected-accounts) to which the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) belongs. format: uuid type: string created_at: description: >- Date and time at which the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) was created. format: date-time type: string display_name: description: >- Display name that corresponds to the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) type. minLength: 1 type: string ends_at: description: >- Date and time at which the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`. type: string errors: description: >- Errors associated with the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials). items: properties: error_code: type: string message: type: string required: - error_code - message type: object type: array external_type: description: >- Brand-specific terminology for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`. enum: - pti_card - brivo_credential - hid_credential - visionline_card - salto_ks_credential - assa_abloy_vostio_key - salto_space_key - latch_access - dormakaba_ambiance_credential - hotek_card - salto_ks_tag - avigilon_alta_credential type: string external_type_display_name: description: >- Display name that corresponds to the brand-specific terminology for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) type. type: string is_issued: description: >- Indicates whether the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) has been encoded onto a card. type: boolean is_latest_desired_state_synced_with_provider: description: >- Indicates whether the latest state of the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) has been synced from Seam to the provider. nullable: true type: boolean is_managed: enum: - true type: boolean is_multi_phone_sync_credential: description: >- Indicates whether the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) is a [multi-phone sync credential](https://docs.seam.co/capability-guides/mobile-access/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials). type: boolean is_one_time_use: description: >- Indicates whether the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) can only be used once. If `true`, the code becomes invalid after the first use. type: boolean issued_at: description: >- Date and time at which the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) was encoded onto a card. format: date-time nullable: true type: string latest_desired_state_synced_with_provider_at: description: >- Date and time at which the state of the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) was most recently synced from Seam to the provider. format: date-time nullable: true type: string parent_acs_credential_id: description: >- ID of the parent [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials). format: uuid type: string starts_at: description: >- Date and time at which the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. type: string user_identity_id: description: >- ID of the [user identity](https://docs.seam.co/api/user_identities/object) to whom the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) belongs. format: uuid type: string visionline_metadata: description: >- Visionline-specific metadata for the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials). properties: auto_join: description: >- Indicates whether the credential should auto-join. For an auto-join credential, Seam automatically issues an override card if there are no other cards and a joiner card if there are existing cards on the doors. type: boolean card_function_type: description: Card function type in the Visionline access system. enum: - guest - staff type: string card_id: description: ID of the card in the Visionline access system. type: string common_acs_entrance_ids: description: Common entrance IDs in the Visionline access system. items: format: uuid type: string type: array credential_id: description: ID of the credential in the Visionline access system. type: string guest_acs_entrance_ids: description: Guest entrance IDs in the Visionline access system. items: format: uuid type: string type: array is_valid: description: Indicates whether the credential is valid. type: boolean joiner_acs_credential_ids: description: IDs of the credentials to which you want to join. items: format: uuid type: string type: array required: - card_function_type type: object warnings: type: array description: >- Warnings associated with the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials). items: type: object properties: error_code: type: string description: Error or warning code. message: type: string description: Human-readable description. created_at: type: string format: date-time description: When this error or warning was generated. workspace_id: description: >- ID of the [workspace](https://docs.seam.co/core-concepts/workspaces) that contains the [credential](https://docs.seam.co/low-level-apis/access-systems/managing-credentials). format: uuid type: string required: - acs_credential_id - connected_account_id - acs_system_id - display_name - access_method - created_at - workspace_id - errors - warnings - is_managed type: object x-route-path: /acs/credentials securitySchemes: client_session: bearerFormat: Client Session Token scheme: bearer type: http pat_with_workspace: bearerFormat: API Token scheme: bearer type: http console_session_with_workspace: bearerFormat: Console Session Token scheme: bearer type: http api_key: bearerFormat: API Key scheme: bearer type: http ````