finov.ioDocumentationHome

Get a bank account

API Documentation / Resources / Bank data

Finovio edit bank account form with name number currency and linked account fields
Each bank account is linked to a BANK-category general ledger account.

Get a bank account

GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/bank-accounts/{bank_account_id}

Required OAuth scope: accounting:read

Returns one active bank account and its linked general-ledger account.

Boundary Behaviour
Another tenant or subsidiary 404 Not Found
Archived bank account 404 Not Found
Account number Returned in its configured display form
Source type Read-only through the developer API

Balance fields are omitted from the item response. Use the collection with balances=true for a balance snapshot.

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.
bank_account_id path Yes string (uuid) UUID of the bank account.

Request

GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/bank-accounts/{bank_account_id} HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}

Responses

Status Description
200 Bank account details.
401 Access token is missing, expired, revoked, or invalid.
403 Token lacks accounting:read or the granted accounting context.
404 Resource does not exist in the granted accounting context.

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",
    "updated_at": "2026-08-10T09:42:16Z"
  }
}