---
title: "List Encoders"
method: POST
path: "/acs/encoders/list"
tags: ["/acs"]
---

# List Encoders

`POST /acs/encoders/list`

## Request

- Base URL: `https://connect.getseam.com`
- URL: `https://connect.getseam.com/acs/encoders/list`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
- TypeScript: <https://skmtc.dev/seam/apis/seam-connect/docs/acs/encoders/list/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of all [encoders](/low-level-apis/access-systems/working-with-card-encoders-and-scanners).

## Request body

- union
  - object
    - `acs_system_id` string, uuid, required: ID of the access system for which you want to retrieve all encoders.
    - `limit` number, float: Number of encoders to return.
    - `page_cursor` string, nullable: Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
  - object
    - `acs_system_ids` string[], required: IDs of the access systems for which you want to retrieve all encoders.
    - `limit` number, float: Number of encoders to return.
    - `page_cursor` string, nullable: Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
  - object
    - `acs_encoder_ids` string[], required: IDs of the encoders that you want to retrieve.
    - `limit` number, float: Number of encoders to return.
    - `page_cursor` string, nullable: Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.

## Response `200`

OK

- object
  - `acs_encoders` AcsEncoder[], required
    - `acs_encoder_id` string, uuid, required: ID of the [encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners).
    - `acs_system_id` string, uuid, required: ID of the [access control system](/low-level-apis/access-systems) that contains the [encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners).
    - `connected_account_id` string, uuid, required: ID of the connected account that contains the [encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners).
    - `created_at` string, date-time, required: Date and time at which the [encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners) was created.
    - `display_name` string, required: Display name for the [encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners).
    - `errors` object[], required: Errors associated with the [encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners).
      - `created_at` string, date-time, required: Date and time at which Seam created the error.
      - `error_code` 'acs_encoder_removed', required: Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
      - `message` string, required: Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
    - `workspace_id` string, uuid, required: ID of the workspace that contains the [encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners).
  - `pagination` Pagination, required: Information about the current page of results.
    - `has_next_page` boolean, required: Indicates whether there is another page of results after this one.
    - `next_page_cursor` string, nullable, required: Opaque value that can be used to select the next page of results via the `page_cursor` parameter.
    - `next_page_url` string, uri, nullable, required: URL to get the next page of results.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/seam/apis/seam-connect.md) - [All operations](https://skmtc.dev/seam/apis/seam-connect/llms.txt) - [OpenAPI document](https://skmtc.dev/seam/apis/seam-connect/revisions/00c35395ce12?raw)