finov.ioDocumentationHome

Balance sheet

API Documentation / Resources / Reports

Finovio balance sheet showing assets liabilities equity and trial balance
Select an account balance to inspect its supporting transactions.

Get a balance sheet report

GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/reports/balance-sheet

Required OAuth scope: reports:read

Returns posted assets, liabilities, and equity at the close of as_at.

Rule Contract
Reporting basis accrual or settlement-based cash
Currency Subsidiary functional currency
Date boundary Includes journals posted through as_at
Current earnings Included in equity until year-end close

A required spot rate that is unavailable returns 400 rather than a partially translated statement.

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.
as_at query Yes string (date)
basis query No string: accrual, cash

Request

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

Responses

Status Description
200 Balance sheet report.
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": {
    "report": "balance_sheet",
    "basis": "accrual",
    "as_at": "2026-07-31",
    "currency_code": "NZD",
    "rows": [
      {
        "label": "Assets",
        "amount": "246800.0000"
      },
      {
        "label": "Liabilities",
        "amount": "-91300.0000"
      },
      {
        "label": "Equity",
        "amount": "-155500.0000"
      }
    ],
    "generated_at": "2026-08-10T17:05:00Z"
  }
}