List bank accounts
API Documentation / Resources / Bank data

List bank accounts
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/bank-accounts
Required OAuth scope: accounting:read
Returns active bank accounts in the authorized subsidiary.
Filters and optional balances
| Parameter | Meaning | Default |
|---|---|---|
source_type |
MANUAL, FEED, or API account ingestion mode |
All modes |
balances |
Include current and reconciled balances | false |
updated_since |
Updated at or after an RFC 3339 timestamp | Unbounded |
page |
One-based page number | 1 |
per_page |
Records per page, from 1 to 100 | 30 |
source_type describes the account connection, not the source of an
individual transaction batch. Results are ordered by account name and
stable resource order.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
tenant_id |
path | Yes | string (uuid) | UUID of the authorized company group. |
subsidiary_id |
path | Yes | string (uuid) | UUID of the subsidiary containing the bank account. |
source_type |
query | No | string: MANUAL, FEED, API | |
balances |
query | No | boolean | |
updated_since |
query | No | string (date-time) | |
page |
query | No | integer | |
per_page |
query | No | integer |
Request
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/bank-accounts HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Responses
| Status | Description |
|---|---|
200 |
A page of active bank accounts. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks accounting:read or the granted accounting context. |
422 |
One or more supplied filters failed validation. |
200 example
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": [
{
"id": "b9d01a74-c53e-461b-bd68-e78a11691a9f",
"name": "ANZ Business Current",
"number": "022-222-2222-2222",
"currency_code": "NZD",
"account_id": "1f386b93-38c5-4a7f-96e8-ce66c71a978d",
"account_code": "0900",
"source_type": "API",
"balance": "12840.4200",
"reconciled_balance": "12110.4200",
"updated_at": "2026-08-10T09:42:16Z"
}
],
"meta": {
"current_page": 1,
"per_page": 30,
"last_page": 1,
"total": 1
}
}