---
title: "Apply a prepared check resolution"
method: POST
path: "/check-quarantine/{bankTransactionId}/apply-prepared"
tags: ["Banking"]
---

# Apply a prepared check resolution

`POST /check-quarantine/{bankTransactionId}/apply-prepared`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/check-quarantine/{bankTransactionId}/apply-prepared`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Supervised apply of one prepared check resolution. Execution kind is always supervised. Core and Tally are accepted. OAuth scope bank_transactions:read_write. Permission post:entries. Request body never accepts target ids; targets come from the locked current evidence row.

## Path parameters

- `bankTransactionId` string, uuid, required

## Request body

- object
  - `evidenceVersion` string, required: Current evidence version digest from inventory
  - `resolutionType` 'category' | 'existing_entry' | 'transfer', required

## Response `200`

Committed prepared resolution receipt

- object
  - `data` PreparedCheckResolutionReceipt, required
    - `bankTransactionId` string, uuid, required
    - `evidenceId` string, uuid, required
    - `evidenceVersion` string, required
    - `resolutionType` 'category' | 'existing_entry' | 'transfer', required
    - `releaseReason` 'image_supported_coding' | 'image_supported_existing_entry' | 'image_supported_transfer', required
    - `finalAccountId` string, uuid, nullable, required
    - `journalEntryId` string, uuid, nullable, required
    - `counterpartId` string, uuid, nullable, required
    - `alreadyApplied` boolean, required
    - `executionKind` 'supervised' | 'tally_wake', required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Stale evidence or concurrent resolution conflict
- `422`: Prepared proposal is no longer eligible
- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)
