finov.ioDocumentationHome

List bank transactions

API Documentation / Resources / Bank data

Finovio Reconciliation workspace showing bank accounts and transactions awaiting reconciliation
Reconciliation brings imported bank transactions together with matching and coding tools.

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