Get a bank account
API Documentation / Resources / Bank data

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