---
title: "Matches two bank transactions as a transfer"
method: POST
path: "/bank-transactions/reconcile/transfer"
tags: ["Cash Matching"]
---

# Matches two bank transactions as a transfer

`POST /bank-transactions/reconcile/transfer`

## Request

- Base URL: `https://api.rillet.com`
- URL: `https://api.rillet.com/bank-transactions/reconcile/transfer`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/rillet/apis/rillet-accounting-api/docs/bank-transactions/reconcile/transfer/post.ts> (a function with typed inputs; its response is checked against the schema)

Matches two bank transactions as a transfer. The source transaction may be incoming or outgoing; the
transaction amounts determine the direction. Cross-subsidiary transfers require access to both subsidiaries.
For a same-subsidiary transfer with a difference, provide reconciliation_adjustment.account_id;
reconciliation_adjustment.fields apply to the adjustment line. If either bank transaction has a fee, provide
fees_account_id to book it. A transfer with fees on both bank transactions is not supported.

## Request body

- MatchBankTransactionsTransferRequest
  - `transaction_id` string, uuid, required: ID of the source bank transaction. Either leg can be incoming or outgoing.
  - `destination_transaction_id` string, uuid, required: ID of the other bank transaction leg in the same organization.
  - `fees_account_id` string, uuid: GL account for a fee on either bank transaction. Required if either leg has a fee; both legs cannot have fees.
  - `reconciliation_adjustment` CashMatchTransferAdjustment
    - `account_id` string, uuid, required: GL account for the difference on a same-subsidiary transfer.
    - `fields` object[]
      - `field_id` string, uuid, required
      - `field_value_id` string, uuid, required

## Response `204`

Bank transactions matched.

## Other responses

- `default`: Error

## Changes

- **2026-11-03** `c393d0102005`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rillet/apis/rillet-accounting-api/changes/bank-transactions/reconcile/transfer/post.md)

---

[API](https://skmtc.dev/rillet/apis/rillet-accounting-api.md) - [All operations](https://skmtc.dev/rillet/apis/rillet-accounting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rillet/apis/rillet-accounting-api/revisions/c393d0102005?raw)