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

# Retrieves a bank transaction

`GET /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/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetches one bank transaction with counterparty text, amounts, and links to the Rillet transactions it settled.
Use the reconciled transaction IDs to retrieve the reconciled bills, invoices, journal entries, or other source records.

## Path parameters

- `bank_transaction_id` string, required

## 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/get.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)