finov.ioDocumentationHome

Transaction detail

API Documentation / Resources / Reports

Finovio Transaction Detail report showing account period and dimension filters
Transaction Detail provides the filtered ledger activity behind account balances.

List transaction detail report rows

GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/reports/transaction-detail

Required OAuth scope: reports:read

Returns immutable posted journal lines with source, contact, and analytical-dimension context.

Filter Match
account_id One general-ledger account
contact_id One customer or supplier contact
dimension_id, element_id One analytical classification pair
source Stable posting source code
search Journal number, account, source, or description text

The effective default order is date ASC followed by stable journal-line order. Amounts are signed in ledger direction.

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 whose ledger is reported.
from_date query Yes string (date)
to_date query Yes string (date)
account_id query No string (uuid)
contact_id query No string (uuid)
dimension_id query No string (uuid)
element_id query No string (uuid)
source query No string
search query No string
page query No integer
per_page query No integer
sort query No string: date, account_code, amount, created_at
order query No string: asc, desc

Request

GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/reports/transaction-detail HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}

Responses

Status Description
200 A page of posted transaction-detail rows.
400 A required exchange rate or report input is unavailable.
401 Access token is missing, expired, revoked, or invalid.
403 Token lacks reports:read or the granted accounting context.
404 A requested subsidiary, account, contact, or bank account is not available in the grant.
422 One or more report parameters failed validation.

200 example

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": [
    {
      "journal_id": "553aa91a-e8c2-4c6f-b800-07a2b92efdb1",
      "date": "2026-07-15",
      "account_id": "a110c7ae-3208-4f93-a64c-d2ba9dd82c31",
      "account_code": "4100",
      "contact_id": "a68d68ec-5866-42e5-8864-57829d3f91b5",
      "source": "invoice",
      "source_id": "f54ca5ce-c915-417b-9514-818ba58a21cb",
      "description": "Advisory services",
      "amount": "-1500.0000",
      "dimensions": [
        {
          "dimension": "Department",
          "element": "Advisory"
        }
      ]
    }
  ],
  "summary": {
    "currency_code": "NZD"
  },
  "meta": {
    "current_page": 1,
    "per_page": 30,
    "last_page": 1,
    "total": 1
  }
}