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