General ledger
API Documentation / Resources / Reports

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