---
title: "Record a transfer pair"
method: POST
path: "/bank-transactions/{bankTransactionId}/record-transfer"
tags: ["Banking"]
---

# Record a transfer pair

`POST /bank-transactions/{bankTransactionId}/record-transfer`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/bank-transactions/{bankTransactionId}/record-transfer`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Human Post pair action. Posts one transfer journal entry claiming both legs of a detected transfer pair atomically through the shared posting service. Counterpart defaults to the best detected pair; pass counterpartId to select a candidate. Works for generic transfers and card-payment review candidates without asserting that a near miss is a proven payment.

## Path parameters

- `bankTransactionId` string, uuid, required

## Request body

- object
  - `counterpartId` string, uuid

## Response `201`

Transfer recorded

## Other responses

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