BizKitHub
DocsAPI ReferenceLedger/api/v1/ledger/vat-ledger
getLedgerPublic API v1

/api/v1/ledger/vat-ledger

VAT ledger (evidence pro DPH, § 100 ZDPH) of one month.

  • basis=tax_point (default) groups by the tax point; claimed groups received VAT by the period it may be claimed in.
  • byFormRow sums per DPH return row, byKhSection per control statement section (A4/A5 and B2/B3 split at 10 000 CZK).
ledgergetApiV1LedgerVat-ledger

Parameters

5 query

Query parameters

· 5
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
periodstringRequired
Example2027-01
direction"issued" | "received"Optional
basis"tax_point" | "claimed"Optional

Response schema

1 status code documented

200Success
periodstringRequired
basisstringRequired
totalsobjectRequired
outputBasenumberRequired

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

Example12100.5
outputVatnumberRequired

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

Example12100.5
inputBasenumberRequired

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

Example12100.5
inputVatnumberRequired

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

Example12100.5
balancenumberRequired

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

Example12100.5
byFormRowobject[]Required
Each array item:
keystringRequired
directionstringRequired
basenumberRequired

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

Example12100.5
vatnumberRequired

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

Example12100.5
countnumberRequired
byKhSectionobject[]Required
Each array item:
keystringRequired
directionstringRequired
basenumberRequired

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

Example12100.5
vatnumberRequired

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

Example12100.5
countnumberRequired
entriesobject[]Required
Each array item:
directionstringRequired
taxPointDatestringRequired
claimedPeriodstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
classificationCodestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
dphFormRowstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
khSectionstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
vatRatenumberRequired
partnerVatIdstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
documentNostring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
documentIdstringRequired
basenumberRequired

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

Example12100.5
vatnumberRequired

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

Example12100.5

Response example

application/json
{
  "period": "example_period",
  "basis": "example_basis",
  "totals": {
    "outputBase": 12100.5,
    "outputVat": 12100.5,
    "inputBase": 12100.5,
    "inputVat": 12100.5,
    "balance": 12100.5
  },
  "byFormRow": [
    {
      "key": "example_key",
      "direction": "example_direction",
      "base": 12100.5,
      "vat": 12100.5,
      "count": 0
    }
  ],
  "byKhSection": [
    {
      "key": "example_key",
      "direction": "example_direction",
      "base": 12100.5,
      "vat": 12100.5,
      "count": 0
    }
  ],
  "entries": [
    {
      "direction": "example_direction",
      "taxPointDate": "example_taxPointDate",
      "vatRate": 0,
      "documentId": "example_documentId",
      "base": 12100.5,
      "vat": 12100.5
    }
  ]
}

Request example

GET /api/v1/ledger/vat-ledger

get
curl -X GET "https://api.bizkithub.com/api/v1/ledger/vat-ledger?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&entityId=Kq3vTnY8mZ0aB1cD2eF3gH4i&period=2027-01" \
  -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