---
title: "Get an Encoder"
method: POST
path: "/acs/encoders/get"
tags: ["/acs"]
---

# Get an Encoder

`POST /acs/encoders/get`

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

## Request body

- object
  - `acs_encoder_id` string, uuid, required — ID of the encoder that you want to get.

## Response `200`

OK

- object
  - `acs_encoder` AcsEncoder, required — Represents a hardware device that encodes [credential](/low-level-apis/access-systems/managing-credentials) data onto physical cards within an [access control system](/low-level-apis/access-systems). See the [acs_encoder object](/api/acs/encoders/object).
    - `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).

## 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)