---
title: "Updates a bank transaction"
method: PUT
path: "/bank-transactions/{bank_transaction_id}"
tags: ["Bank Transactions"]
---

# Updates a bank transaction

`PUT /bank-transactions/{bank_transaction_id}`

## Request

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

Adjusts memo, categorization, or reconciliation metadata on an existing bank transaction without re-importing the entire feed batch.
Supply the full body expected by the schema so optional fields you intend to keep are not unintentionally cleared.

## Path parameters

- `bank_transaction_id` string, required

## Request body

- UpdateBankTransactionRequest
  - `date` string, date, required
  - `name` string, required: Transaction description
  - `merchant` string, required: Merchant or counterparty name
  - `net_amount` RoundedMonetaryAmount, required: A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
    - `amount` string, required: Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
    - `currency` string, required: Currency code following ISO-4217
  - `fee` RoundedMonetaryAmount: A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
    - `amount` string, required: Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
    - `currency` string, required: Currency code following ISO-4217
  - `pending` boolean: Whether the transaction is still pending
  - `excluded` boolean: Whether the transaction is excluded from reconciliation
  - `external_references` ExternalReference[]
    - `type` string, required
    - `id` string, required
    - `url` string, uri

## Response `200`

OK

- BankTransaction
  - `id` string, uuid, required
  - `bank_account_id` string, uuid, required
  - `subsidiary_id` string, uuid, required
  - `date` string, date, required
  - `name` string, required: Transaction description
  - `merchant` string, required: Merchant or counterparty name
  - `net_amount` RoundedMonetaryAmount, required: A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
    - `amount` string, required: Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
    - `currency` string, required: Currency code following ISO-4217
  - `fee` RoundedMonetaryAmount, required: A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
    - `amount` string, required: Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
    - `currency` string, required: Currency code following ISO-4217
  - `pending` boolean, required: Whether the transaction is still pending
  - `excluded` boolean, required: Whether the transaction is excluded from reconciliation
  - `external_references` ExternalReference[]
    - `type` string, required
    - `id` string, required
    - `url` string, uri
  - `reconciled_transactions` ReconciledTransaction[], required: Rillet transactions matched to this bank transaction. Empty when the bank transaction is unmatched.
    - `id` string, uuid, required: ID of the reconciled Rillet transaction
    - `type` 'BILL' | 'CHARGE' | 'REIMBURSEMENT' | 'INVOICE' | 'CREDIT_MEMO' | 'VENDOR_CREDIT' | 'JOURNAL_ENTRY' | 'BANK_TRANSACTION', required: Type of the reconciled Rillet transaction
    - `payment_id` string, uuid: ID of the invoice or expense payment this match created or cleared. Each entry is one payment, so several payments against the same invoice appear as separate entries. Present on INVOICE, BILL, CHARGE and REIMBURSEMENT entries, and on JOURNAL_ENTRY entries that cleared a previously recorded payment.
    - `amount` RoundedMonetaryAmount: A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
      - `amount` string, required: Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
      - `currency` string, required: Currency code following ISO-4217
    - `paid_transaction` PaidTransaction
      - `id` string, uuid, required: ID of the invoice or expense
      - `type` 'INVOICE' | 'BILL' | 'CHARGE' | 'REIMBURSEMENT', required: Type of the invoice or expense

## Other responses

- `default`: Error

## Changes

- **2026-11-03** `c393d0102005`: 1 info
  - added the required property `reconciled_transactions` to the response with the `200` status

[Operation history](https://skmtc.dev/rillet/apis/rillet-accounting-api/changes/bank-transactions/:bank_transaction_id/put.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)