---
title: "Retrieves a bank account"
method: GET
path: "/bank-accounts/{bank_account_id}"
tags: ["Bank accounts"]
---

# Retrieves a bank account

`GET /bank-accounts/{bank_account_id}`

## Request

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

Returns configuration and status for a single bank account, including identifiers downstream connectors need when refreshing balances.
Use before deleting or updating metadata so you preserve institution codes and default subsidiary routing.

## Path parameters

- `bank_account_id` string, required

## Response `200`

OK

- BankAccount
  - `id` string, uuid, required
  - `name` string, required: The bank account name
  - `currency` string, required: Currency code following ISO-4217
  - `bank_name` string, required
  - `subsidiary_id` string, uuid
  - `account_code` string: The account code found in the Chart of Accounts
  - `mask` string: Last digits of the bank account number
  - `transactions_start_date` string, date, nullable: The earliest date from which bank transactions are tracked for this account. Omitted for pre-existing accounts that have no recorded start date.
  - `status` 'ACTIVE' | 'INACTIVE', required

## Other responses

- `default`: Error

---

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