---
title: "Encode a Credential"
method: POST
path: "/acs/encoders/encode_credential"
tags: ["/acs"]
---

# Encode a Credential

`POST /acs/encoders/encode_credential`

Encodes an existing [credential](/low-level-apis/access-systems/managing-credentials) onto a plastic card placed on the specified [encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners). Either provide an `acs_credential_id` or an `access_method_id`

## Request body

- object
  - `access_method_id` string, uuid — ID of the `access_method` to encode onto a card.
  - `acs_credential_id` string, uuid — ID of the `acs_credential` to encode onto a card.
  - `acs_encoder_id` string, uuid, required — ID of the `acs_encoder` to use to encode the `acs_credential`.

## Response `200`

OK

- object
  - `action_attempt` object, required — Tracks the progress of this operation. Poll using the action_attempt_id. See the [action_attempt object](/api/action_attempts/object).
    - `action_attempt_id` string, uuid, required — ID of the action attempt.
    - `action_type` 'ENCODE_CREDENTIAL', required — Type of action being tracked.
    - `status` 'pending' | 'success' | 'error', required — Current status of the action.
    - `result` object, nullable — Result payload on success.
    - `error` object, nullable — Error details on failure.
      - `type` string
      - `message` string

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