Financials
Order the financial statements a company has filed with its register, read each period, retrieve the original filing, and see where financials are available.
A financials order returns the financial statements a company has filed with
its official register, as structured periods: income statement, balance sheet,
cash flow statement, headcount and computed ratios. It takes a kausateId.
| Endpoint | What it does |
|---|---|
POST /v2/companies/finance | Places an order and returns its orderId at once. |
POST /v2/companies/finance/sync | Places an order and waits for the result, up to 300 seconds. |
GET /v2/companies/finance/{orderId} | Returns the order's status and, once complete, its statements. |
GET /v2/companies/finance/{orderId}/content/{buildId} | Returns the original filing's HTML, in pages. |
GET /v2/companies/finance/{orderId}/content/{buildId}/published | Returns the filing's own cells and text, in pages. |
Order financials
curl -X POST https://api.kausate.com/v2/companies/finance/sync \
-H "X-API-Key: $API_KEY" \
-H "Kausate-Version: 2026-08-01" \
-H "Content-Type: application/json" \
-d '{"kausateId": "co_zz_1a82xPhiHFOOz7CbClDfEI"}'The synchronous endpoint suits testing and one-off requests. In production,
order with POST /v2/companies/finance: it returns an orderId and a
resultUrl to poll with
Get Financials Order, and a
webhook delivers the completed order. See
Requests: sync & async.
The request body:
| Field | Type | Required | Description |
|---|---|---|---|
kausateId | string | Yes | Kausate universal company identifier (format: co_{jurisdiction}_{id}) |
customerReference | string or null | No | |
metadata | object or null | No | Optional customer-supplied JSON metadata echoed back in order responses. Serialized JSON must be at most 4096 bytes. |
globalTimeout | integer or null | No | Optional order time budget in whole minutes (1–10080). At expiry, the order stops acquisition and may spend additional time settling billing and cleanup. Shorter endpoint timeouts still apply. |
advanced | GermanFinancialsOptions or null | No | Germany financials options. Only supported for German companies; document purchasing is disabled by default. |
bypassCache | boolean | No | If true, bypass daily deduplication and force a fresh request. |
The same order for the same company on the same UTC day returns the existing
order and is not charged again. Set bypassCache: true to place a fresh one.
Germany: deposited annual accounts
For a German company, advanced.allowDepositedAccountsPurchase lets the order
buy the latest annual accounts deposited with the register when no financial
statements are found otherwise. It is off by default, and buying the accounts
adds a charge to the order. Send it only when you accept that cost:
{
"kausateId": "co_de_7aH2IUvdvC6XGzbUbSyhOU",
"advanced": { "allowDepositedAccountsPurchase": true }
}advanced applies to German companies only: for any other company the request
is rejected with HTTP 422 and the code request.invalid.
Read the result
The completed order holds result:
| Field | Type | Required | Description |
|---|---|---|---|
type | "financials" | No | |
statements | array of FinancialPeriod | Yes | Financial periods, ordered by periodEnd descending |
sources | map of FinancialsSource | Yes | Data source information |
contentDocuments | array of FinancialContentDocument | No | Original filing documents available for download. Retrieve the content by build ID through the financials content endpoint. |
statements lists one entry per financial period, latest periodEnd first:
| Field | Type | Required | Description |
|---|---|---|---|
metadata | FinancialsMetadata | Yes | |
incomeStatement | IncomeStatement or null | No | |
balanceSheet | BalanceSheet or null | No | |
cashFlowStatement | CashFlowStatement or null | No | |
numberOfEmployees | integer or null | No | Average number of employees in the period. |
ratios | FinancialRatios or null | Yes | Standard financial ratios computed from this period's statements. A source-linked annual employee interval can also use authenticated closing-stock operands. Null when no ratio has usable inputs. |
A company with no filed statements returns an empty statements list.
Period metadata
Read a period's metadata before comparing figures:
| Field | Type | Required | Description |
|---|---|---|---|
periodStart | string or null | No | Start of fiscal period (ISO 8601 date) |
periodEnd | string or null | No | End of fiscal period (ISO 8601 date) |
filingDate | string or null | No | When filed with registry |
currency | string or null | No | ISO 4217 currency code (e.g., EUR, GBP) |
scope | FinancialStatementScope or null | No | Whether the statement covers the single entity or the group. |
audited | boolean or null | No | True = audited, False = unaudited |
accountingStandard | AccountingStandard or null | No | Accounting standard used |
statementType | StatementType or null | No | Annual or interim |
isMicroEntity | boolean or null | No | True if filed under micro-entity regime |
reportingScale | ReportingScale or null | No | Scale the source statements were filed in (units/thousands/millions) before normalization. All monetary values in this response are normalized to full currency units regardless of this value. |
source | string or null | No | Registry source key |
- Currency. Each period carries its own
currency. Two periods of one company can differ. - Scale. Every amount is in full currency units.
reportingScaleonly records the scale the filing used, such as thousands. - Scope. A company can file both its own accounts (
entity) and its group's consolidated accounts (group) for the same period. Compare periods of the same scope. - Annual or interim.
statementTypesays whether the period is a full financial year or part of one.
statementType values:
| Value |
|---|
annual |
interim |
scope values:
| Value |
|---|
entity |
group |
reportingScale values:
| Value |
|---|
units |
thousands |
millions |
accountingStandard values:
| Value |
|---|
HGB |
IFRS |
LOCAL_GAAP |
SIMPLIFIED_IFRS |
US_GAAP |
FRS_101 |
FRS_102 |
FRS_105 |
AUSTRIAN_UGB |
BELGIAN_GAAP |
SWISS_GAAP_FER |
LUXEMBOURG_GAAP |
DUTCH_GAAP |
JAPANESE_GAAP |
AUSTRALIAN_ACCOUNTING_STANDARDS |
DANISH_FINANCIAL_STATEMENTS_ACT |
NORWEGIAN_GAAP |
NEW_ZEALAND_GAAP |
FINNISH_GAAP |
POLISH_ACCOUNTING_ACT |
Statements
Amounts are decimal strings, such as "4200000", so no precision is lost in
JSON. A null field means the filing does not give that line; it does not
mean zero.
Which lines a period carries depends on what the company filed. A small company's abridged accounts can hold a balance sheet and no income statement.
Income statement (incomeStatement):
| Field | Type | Required | Description |
|---|---|---|---|
revenue | string or null | No | Net sales / turnover |
otherOperatingIncome | string or null | No | Other operating income |
totalOperatingIncome | string or null | No | Total operating income |
costOfGoodsAndServices | string or null | No | Cost of goods sold (COGS) |
personnelCosts | string or null | No | Wages, salaries, social contributions |
depreciationAndAmortization | string or null | No | Depreciation and amortization |
otherOperatingExpenses | string or null | No | Other operating expenses |
totalOperatingExpenses | string or null | No | Total operating expenses |
operatingProfit | string or null | No | Operating profit (EBIT equivalent) |
financialIncome | string or null | No | Financial income |
financialExpenses | string or null | No | Financial expenses |
netFinancialResult | string or null | No | Net financial result |
profitBeforeTax | string or null | No | Profit before tax |
incomeTax | string or null | No | Income tax expense |
profitAfterTax | string or null | No | Net income / profit after tax |
extraordinaryItems | string or null | No | Extraordinary items |
minorityInterests | string or null | No | Minority interests |
grossProfit | string or null | No | Gross profit = revenue − cost of goods and services (memo line) |
ebitda | string or null | No | EBITDA = operating profit + depreciation & amortization (memo line) |
cashFlow | string or null | No | Cash flow = net income + depreciation & amortization (memo line) |
Balance sheet (balanceSheet):
| Field | Type | Required | Description |
|---|---|---|---|
intangibleAssets | string or null | No | Intangible assets |
goodwill | string or null | No | Goodwill |
propertyPlantAndEquipment | string or null | No | Property, plant and equipment |
financialAssets | string or null | No | Long-term financial assets / investments |
totalNonCurrentAssets | string or null | No | Total non-current assets |
inventories | string or null | No | Inventories |
tradeReceivables | string or null | No | Trade receivables |
otherReceivables | string or null | No | Other receivables |
cashAndCashEquivalents | string or null | No | Cash and cash equivalents |
otherCurrentAssets | string or null | No | Other current assets |
totalCurrentAssets | string or null | No | Total current assets |
totalAssets | string or null | No | Total assets |
shareCapital | string or null | No | Share capital |
sharePremium | string or null | No | Share premium |
retainedEarnings | string or null | No | Retained earnings |
otherReserves | string or null | No | Other reserves |
totalEquity | string or null | No | Total equity |
longTermBorrowings | string or null | No | Long-term borrowings |
provisions | string or null | No | Provisions |
deferredTaxLiabilities | string or null | No | Deferred tax liabilities |
otherNonCurrentLiabilities | string or null | No | Other non-current liabilities |
totalNonCurrentLiabilities | string or null | No | Total non-current liabilities |
tradePayables | string or null | No | Trade payables |
shortTermBorrowings | string or null | No | Short-term borrowings |
otherCurrentLiabilities | string or null | No | Other current liabilities |
totalCurrentLiabilities | string or null | No | Total current liabilities |
totalLiabilities | string or null | No | Total liabilities |
workingCapital | string or null | No | Working capital = total current assets − total current liabilities (memo line) |
netDebt | string or null | No | Net debt = long-term + short-term borrowings − cash & equivalents (memo line) |
Cash flow statement (cashFlowStatement):
| Field | Type | Required | Description |
|---|---|---|---|
cashFromOperatingActivities | string or null | No | Cash from operating activities |
cashFromInvestingActivities | string or null | No | Cash from investing activities |
cashFromFinancingActivities | string or null | No | Cash from financing activities |
netChangeInCash | string or null | No | Net change in cash |
exchangeRateEffect | string or null | No | Exchange rate effect on cash |
cashAtBeginning | string or null | No | Cash at beginning of period |
cashAtEnd | string or null | No | Cash at end of period |
Ratios
Each period's ratios are computed from the figures in that period, with the
same definitions for every jurisdiction. ratios is null when no ratio has
the figures it needs. See Financial ratios.
Sources
sources describes each register a figure comes from, keyed by the value a
period's metadata.source names:
| Field | Type | Required | Description |
|---|---|---|---|
dataSource | string | Yes | Data source slug, e.g. de-handelsregister. |
type | SourceType | Yes | |
name | string | Yes | |
jurisdictionCode | Jurisdiction | Yes | |
retrievalTime | string or null | No | When this source was retrieved. Absent on older reports. |
downloadUrl | string or null | No | |
fileHash | string or null | No | |
fileName | string or null | No | |
date | DateInfo or null | No |
Original filings
Where the filing itself is available, contentDocuments lists it by
buildId. Two endpoints return it:
GET /v2/companies/finance/{orderId}/content/{buildId}returns the original filing's HTML, wrapped in a JSON document.GET /v2/companies/finance/{orderId}/content/{buildId}/publishedreturns the filing's own cells and narrative sections as the register publishes them, including filings that have no structured periods. The cells keep the filing's own labels; they are not mapped to the statement fields above.
Both return a compressed file in pages of at most 65,536 bytes. Request the
first page with offset=0, then each nextOffset until it is null. Join the
Base64-decoded content of every page, check the result against
artifactSha256, and decompress it with zstd.
The original filing's page:
| Field | Type | Required | Description |
|---|---|---|---|
buildId | string | Yes | |
sourceSha256 | string | Yes | |
contentSha256 | string | Yes | |
artifactSha256 | string | Yes | SHA-256 of the immutable compressed artifact |
format | "kausate.complete-html-document.v1+json+zstd" | No | |
encoding | "base64" | No | |
contentType | string | Yes | Immutable artifact media type and codec |
totalBytes | integer | Yes | |
offset | integer | Yes | |
content | string | Yes | Base64-encoded compressed artifact bytes. Concatenate all pages, verify artifactSha256, decompress zstd, then verify contentSha256 before reading the ordered source-bound JSON document. |
nextOffset | integer or null | No |
The published filing's page:
| Field | Type | Required | Description |
|---|---|---|---|
buildId | string | Yes | |
completeDocumentBuildId | string | Yes | |
sourceSha256 | string | Yes | |
filingSha256 | string | Yes | SHA-256 of canonical nested PublishedFinancialFiling JSON |
sourceGraphSha256 | string | Yes | |
buildInventorySha256 | string | Yes | |
interpretationStatus | "partial" | No | |
artifactSha256 | string | Yes | SHA-256 of the entire immutable compressed envelope |
format | "kausate.published-financial-filing-envelope.v1+json+zstd" | No | |
encoding | "base64" | No | |
contentType | string | Yes | |
totalBytes | integer | Yes | |
offset | integer | Yes | |
content | string | Yes | Concatenate decoded pages and verify artifactSha256 before zstd decompression. Read publishedFiling from the envelope; filingSha256 authenticates that nested typed object's canonical JSON, not the entire decompressed envelope. Source-labelled cells, narrative sections and asset references retain unresolved semantics. |
nextOffset | integer or null | No |
What to expect per jurisdiction
Registers differ in what companies file and publish. How many years an order returns, and whether it includes interim or group statements, depends on the register and on what each company has filed. Kausate does not promise a number of years or a statement type for any jurisdiction. Each jurisdiction guide notes what its register publishes.
Where financials are available
| Region | Jurisdiction | Availability |
|---|---|---|
| Europe | Austria | Live |
| Europe | Belgium | Live |
| Europe | Czechia | Live |
| Europe | Denmark | Live |
| Europe | Estonia | Live |
| Europe | France | Live |
| Europe | Germany | Live |
| Europe | Greenland | Live |
| Europe | Hungary | Live |
| Europe | Ireland | Live |
| Europe | Italy | Live |
| Europe | Latvia | Live |
| Europe | Lithuania | Live |
| Europe | Netherlands | Live |
| Europe | Norway | Live |
| Europe | Poland | Live |
| Europe | Romania | Live |
| Europe | Russian Federation | Live |
| Europe | Slovakia | Live |
| Europe | Slovenia | Limited access |
| Europe | Sweden | Live |
| Europe | Ukraine | Live |
| Europe | United Kingdom | Live |
| Americas | Brazil | Live |
| Americas | Colombia | Live |
| Americas | French Guiana | Live |
| Americas | Guadeloupe | Live |
| Americas | Martinique | Live |
| Americas | Mexico | Live |
| Americas | Saint Barthélemy | Live |
| Americas | Saint Martin (French part) | Live |
| Americas | United States | Live |
| Asia Pacific | Japan | Live |
| Asia Pacific | Marshall Islands | Live |
| Asia Pacific | South Korea | Live |
| Asia Pacific | Uzbekistan | Live |
| Middle East & Africa | Mayotte | Live |
| Middle East & Africa | Réunion | Live |
Live jurisdictions can be ordered now. Limited access jurisdictions are switched on per organisation: contact us to use one.
Try the endpoints without charge in the sandbox: Sandbox
Industries GmbH (co_zz_1a82xPhiHFOOz7CbClDfEI) returns two financial
periods.
Costs
A financials order is charged once it completes; a failed order is not. Polling an order and every financials call against the sandbox are free. Prices depend on the jurisdiction: see Credits and billing.
Related guides
- Financial ratios: how each ratio is computed
- Monitoring: events when a company publishes new financial statements
- Documents: order annual accounts as a file
- Errors: codes on a failed order
Last updated on