BizKitHub
DocsAPI ReferenceLedger/api/v1/ledger/trial-balance
getLedgerPublic API v1

/api/v1/ledger/trial-balance

Trial balance (obratová předvaha) for one fiscal period.

Range

  • fiscalYear picks the period; default is the newest open period.
  • from / to narrow the range and are clamped to the period bounds.

Semantics

  • Opening (PS) = opening entry + movements of the period before from; balance accounts carry forward when no opening entry exists.
  • Opening and closing balances are netted to one side; turnovers are gross.
  • analytics=false rolls analytic accounts into their synthetic account.
  • afterClosing=true includes closing entries.
  • checks are the control equations (Σ MD = Σ Dal, trial balance turnover = journal turnover).
ledgergetApiV1LedgerTrial-balance

Parameters

7 query

Query parameters

· 7
apiKeystringRequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

ExamplePRODPGrFxpGEtrOZfuWhnoJohUYBXuOE
entityIdstringRequired

Accounting entity id (from /ledger/entity-list).

Length: 16–24
ExampleKq3vTnY8mZ0aB1cD2eF3gH4i
fiscalYearstring | numberOptional
Range: 1900–2999
fromstringOptional
Example2026-03-31
tostringOptional
Example2026-03-31
analyticsboolean | stringOptional
Default: true
Exampletrue
afterClosingboolean | stringOptional
Default: false
Examplefalse

Response schema

1 status code documented

200Success
fiscalYearnumberRequired
fromstringRequired
tostringRequired
rowsobject[]Required
Each array item:
codestringRequired
namestringRequired
typestringRequired
openingDebitnumberRequired

Amount in the base currency of the accounting entity (2 decimals).

Example12100.5
openingCreditnumberRequired

Amount in the base currency of the accounting entity (2 decimals).

Example12100.5
turnoverDebitnumberRequired

Amount in the base currency of the accounting entity (2 decimals).

Example12100.5
turnoverCreditnumberRequired

Amount in the base currency of the accounting entity (2 decimals).

Example12100.5
closingDebitnumberRequired

Amount in the base currency of the accounting entity (2 decimals).

Example12100.5
closingCreditnumberRequired

Amount in the base currency of the accounting entity (2 decimals).

Example12100.5
totalsobjectRequired
openingDebitnumberRequired

Amount in the base currency of the accounting entity (2 decimals).

Example12100.5
openingCreditnumberRequired

Amount in the base currency of the accounting entity (2 decimals).

Example12100.5
turnoverDebitnumberRequired

Amount in the base currency of the accounting entity (2 decimals).

Example12100.5
turnoverCreditnumberRequired

Amount in the base currency of the accounting entity (2 decimals).

Example12100.5
closingDebitnumberRequired

Amount in the base currency of the accounting entity (2 decimals).

Example12100.5
closingCreditnumberRequired

Amount in the base currency of the accounting entity (2 decimals).

Example12100.5
checksobjectRequired
turnoverBalancedbooleanRequired
openingBalancedbooleanRequired
closingBalancedbooleanRequired
matchesJournalbooleanRequired

Response example

application/json
{
  "fiscalYear": 0,
  "from": "example_from",
  "to": "example_to",
  "rows": [
    {
      "code": "example_code",
      "name": "example_name",
      "type": "example_type",
      "openingDebit": 12100.5,
      "openingCredit": 12100.5,
      "turnoverDebit": 12100.5,
      "turnoverCredit": 12100.5,
      "closingDebit": 12100.5,
      "closingCredit": 12100.5
    }
  ],
  "totals": {
    "openingDebit": 12100.5,
    "openingCredit": 12100.5,
    "turnoverDebit": 12100.5,
    "turnoverCredit": 12100.5,
    "closingDebit": 12100.5,
    "closingCredit": 12100.5
  },
  "checks": {
    "turnoverBalanced": false,
    "openingBalanced": false,
    "closingBalanced": false,
    "matchesJournal": false
  }
}

Request example

GET /api/v1/ledger/trial-balance

get
curl -X GET "https://api.bizkithub.com/api/v1/ledger/trial-balance?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&entityId=Kq3vTnY8mZ0aB1cD2eF3gH4i&from=2026-03-31&to=2026-03-31&analytics=true&afterClosing=false" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key