finov.ioDocumentationHome

Get a bank transaction

API Documentation / Resources / Bank data

Get a bank transaction

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

Required OAuth scope: accounting:read

Returns one transaction and its reconciliation summary.

Transaction state reconciliation
Unreconciled null
Reconciled Journal, source record, and reconciliation timestamp

A transaction is resolved inside the tenant, subsidiary, and bank account hierarchy. A row outside any part of that hierarchy is not disclosed and returns 404 Not Found.

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.
transaction_id path Yes string (uuid) UUID of a transaction in the identified bank account.

Request

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

Responses

Status Description
200 Bank transaction and reconciliation 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": "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": true,
    "reconciliation": {
      "journal_id": "94db6332-f1ce-4322-a049-f5880189e8ef",
      "source_type": "INVOICE",
      "source_id": "3c20582f-e778-4086-93a7-4c39ecfbd829",
      "reconciled_at": "2026-08-10T10:14:22Z"
    },
    "created_at": "2026-08-10T09:43:00Z",
    "updated_at": "2026-08-10T10:14:22Z"
  }
}