finov.ioDocumentationHome

General ledger

API Documentation / Resources / Reports

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

Get a general ledger report

GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/reports/general-ledger

Required OAuth scope: reports:read

Returns posted journal lines for one account with opening, running, and closing balances.

Parameter Meaning Default
account_id Ledger account to report Required
from_date, to_date Inclusive activity period Required
basis Accrual or settlement-based cash projection accrual
contact_id Restrict entries to one contact All contacts
source Restrict by stable source code All sources

Rows are ordered by date, journal number, then stable line order unless the caller requests another supported ordering.

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.
account_id query Yes string (uuid)
from_date query Yes string (date)
to_date query Yes string (date)
basis query No string: accrual, cash
contact_id query No string (uuid)
source query No string
page query No integer
per_page query No integer

Request

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

Responses

Status Description
200 A page of general-ledger entries.
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",
      "journal_number": "JRN-2026-0082",
      "date": "2026-07-15",
      "description": "Sales invoice INV-2026-0042",
      "debit": "1725.0000",
      "credit": "0.0000",
      "amount": "1725.0000",
      "running_balance": "28400.0000"
    }
  ],
  "summary": {
    "account_id": "a110c7ae-3208-4f93-a64c-d2ba9dd82c31",
    "opening_balance": "26675.0000",
    "closing_balance": "28400.0000",
    "currency_code": "NZD"
  },
  "meta": {
    "current_page": 1,
    "per_page": 30,
    "last_page": 1,
    "total": 1
  }
}