---
title: "Simulate that the Next Credential Scan Will Fail"
method: POST
path: "/acs/encoders/simulate/next_credential_scan_will_fail"
tags: ["/acs"]
---

# Simulate that the Next Credential Scan Will Fail

`POST /acs/encoders/simulate/next_credential_scan_will_fail`

## Request

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

Simulates that the next attempt to scan a [credential](/low-level-apis/access-systems/managing-credentials) using the specified [encoder](/low-level-apis/access-systems/working-with-card-encoders-and-scanners) will fail. You can only perform this action within a [sandbox workspace](/core-concepts/workspaces#sandbox-workspaces).

## Request body

- union
  - object
    - `acs_encoder_id` string, uuid, required: ID of the `acs_encoder` that will fail to scan the `acs_credential` in the next request.
    - `error_code` 'no_credential_on_encoder'
  - object
    - `acs_credential_id_on_seam` string, uuid
    - `acs_encoder_id` string, uuid, required: ID of the `acs_encoder` that will fail to scan the `acs_credential` in the next request.
    - `error_code` 'uncategorized_error' | 'action_attempt_expired', required

## Response `200`

OK

- object

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