finov.ioDocumentationHome

List bank accounts

API Documentation / Resources / Bank data

Finovio Bank accounts page showing configured accounts balances and linked ledger accounts
Review account numbers, currencies, linked accounts, balances, and unmapped items.

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
  }
}