List bank transactions
API Documentation / Resources / Bank data

List bank transactions
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/bank-accounts/{bank_account_id}/transactions
Required OAuth scope: accounting:read
Returns undeleted transactions for one bank account.
Filters and ordering
| Parameter | Meaning | Default |
|---|---|---|
mapped |
Reconciled (true) or unreconciled (false) rows |
Both |
from_date, to_date |
Inclusive transaction-date bounds | Unbounded |
batch_id |
Restrict to one batch in this account | All batches |
updated_since |
Updated at or after an RFC 3339 timestamp | Unbounded |
search |
Details, particulars, code, or reference text | No search |
sort |
date, amount, created_at, or updated_at |
date |
order |
asc or desc |
asc |
Equal sort values use stable transaction order. Positive amounts are inflows and negative amounts are outflows.
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. |
mapped |
query | No | boolean | |
from_date |
query | No | string (date) | |
to_date |
query | No | string (date) | |
batch_id |
query | No | string (uuid) | |
updated_since |
query | No | string (date-time) | |
search |
query | No | string | |
page |
query | No | integer | |
per_page |
query | No | integer | |
sort |
query | No | string: date, amount, created_at, updated_at | |
order |
query | No | string: asc, desc |
Request
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/bank-accounts/{bank_account_id}/transactions HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Responses
| Status | Description |
|---|---|
200 |
A page of bank transactions. |
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. |
422 |
One or more supplied filters failed validation. |
200 example
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": [
{
"id": "7af4aa6b-bb1f-4137-874e-f1ec4488c477",
"batch_id": "ad2f5fe3-d5e6-4234-b921-a70d4bf04f44",
"line": 1,
"date": "2026-07-03",
"type": "DIRECT_CREDIT",
"details": "Customer payment",
"particulars": "ASTER RIDGE",
"code": "INV-1048",
"reference": "BANK-90814",
"amount": "1250.0000",
"mapped": false,
"created_at": "2026-08-10T09:43:00Z",
"updated_at": "2026-08-10T09:43:00Z"
}
],
"meta": {
"current_page": 1,
"per_page": 30,
"last_page": 1,
"total": 1
}
}