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

# List Encoders

`POST /acs/encoders/list`

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.net/seam/apis/seam-connect.md) · [All operations](https://skmtc.net/seam/apis/seam-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/seam/seam-connect/versions/00c35395ce12/schema)