BizKitHub
DocsAPI ReferenceLedger/api/v1/ledger/journal
getLedgerPublic API v1

/api/v1/ledger/journal

Posted journal entries (účetní deník), newest first, paginated.

Filters

  • fiscalYear, dateFrom, dateTo: accounting date range.
  • accountCode: prefix match on any line's account (311 matches 311.100).

Reversals (storno) are regular entries linked by reversesEntryId. Lines are in /ledger/journal-detail.

ledgergetApiV1LedgerJournal

Parameters

8 query

Query parameters

· 8
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
dateFromstringOptional
Example2026-03-31
dateTostringOptional
Example2026-03-31
accountCodestringOptional
Length: 0–16
Example311
pagestring | numberOptional
Range: 1–∞Default: 1
Example1
limitstring | numberOptional
Range: 1–500Default: 100
Example100

Response schema

1 status code documented

200Success
itemsobject[]Required
Each array item:
idstringRequired

Journal entry id.

entryNostring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
entryDatestringRequired

Accounting date (YYYY-MM-DD).

documentDatestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
documentNostring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
descriptionstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
amountnumberRequired

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

Example12100.5
sourceTypestringRequired

Origin document type (manual, invoice, bank, …).

originstringRequired

manual, document, opening, closing, adjustment, …

fiscalYearnumberRequired
reversesEntryIdstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
reversedByEntryIdstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
accountCodesstring[]Required
itemCountnumberRequired
pagenumberRequired
limitnumberRequired

Response example

application/json
{
  "items": [
    {
      "id": "example_id",
      "entryDate": "example_entryDate",
      "amount": 12100.5,
      "sourceType": "example_sourceType",
      "origin": "example_origin",
      "fiscalYear": 0,
      "accountCodes": [
        "string"
      ]
    }
  ],
  "itemCount": 0,
  "page": 0,
  "limit": 0
}

Request example

GET /api/v1/ledger/journal

get
curl -X GET "https://api.bizkithub.com/api/v1/ledger/journal?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&entityId=Kq3vTnY8mZ0aB1cD2eF3gH4i&dateFrom=2026-03-31&dateTo=2026-03-31&accountCode=311&page=1&limit=100" \
  -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