Data

DATA

balance_sheet_accounts · profit_and_loss_account · annual_financial_statements

Reference of the statement features of fetch-organization: balance sheets and profit-and-loss statements as account trees, each fiscal year with its source, plus complete annual statements as text. With Max, the years of energy utilities also hold their activity statements. Amounts are in euros.

balance_sheet_accounts (3 credits)

Key	Type	Description
[]	array<object>	One entry per fiscal year, newest first. An empty array when no balance sheet is known.
[].year	number	Calendar year in which the fiscal year ends: a fiscal year from July 2024 to June 2025 is 2025. The exact period is in _provenance.
[].balance_sheet_accounts	array<object>	Account tree. Top level: Aktivseite (assets) and Passivseite (equity and liabilities). Identify them by name.de, not by position, as a side can be missing.
[].balance_sheet_accounts[].name	object	Item name. de: the standard German name of a known account, otherwise the caption as printed. en: present only for known accounts, never null. in_report: the caption as printed in the filing (string or null). Identify accounts by de.
[].balance_sheet_accounts[].value	number \| null	Amount in euros. Losses in equity (Jahresfehlbetrag, Verlustvortrag, Bilanzverlust) are negative. null where market data has no figure for a row.
[].balance_sheet_accounts[].children	array<object>	Sub-items with the same structure, nested as the filing groups them; the depth of an account can differ between filings. davon (thereof) rows are already included in their parent's amount.
[]._provenance	object	Source of this year's balance sheet, on every plan. Fields below.
[].activity_statements Max	array<object>	Max only: the activity balance sheets of energy utilities, see below. The key is missing when the year has none.

profit_and_loss_account (3 credits)

Key	Type	Description
[]	array<object>	One entry per fiscal year, newest first. An empty array when no P&L is known, which is common for small companies that publish only a balance sheet.
[].year	number	Calendar year in which the fiscal year ends: a fiscal year from July 2024 to June 2025 is 2025. The exact period is in _provenance.
[].profit_and_loss_accounts	array<object>	P&L items in the order and structure of the filing. The top level also holds printed subtotals and results such as Betriebsergebnis or Jahresüberschuss: do not sum it, use the result rows.
[].profit_and_loss_accounts[].name	object	As in the balance sheet: de, en and in_report. in_report also carries outline numbers such as "a) Löhne und Gehälter".
[].profit_and_loss_accounts[].value	number \| null	Amount in euros. Expenses carry the sign printed in the filing, positive or negative, so compare magnitudes. null where market data has no figure for a row.
[].profit_and_loss_accounts[].children	array<object>	Sub-items with the same structure, nested as printed. davon (thereof) rows are already included in their parent's amount.
[]._provenance	object	Source of this year's P&L, on every plan. Fields below.
[].activity_statements Max	array<object>	Max only: the activity P&Ls of energy utilities, see below. The key is missing when the year has none.

_provenance: where the figures come from

On every plan, every year of balance_sheet_accounts, profit_and_loss_account and financial_kpi carries _provenance, and so does every item of activity_statements. The balance sheet, P&L and KPIs of the same year can come from different sources, so read the _provenance of each.

Key	Type	Description
_provenance.statement_type	string \| null	Kind of statement: Jahresabschluss (the company's annual accounts), Bilanz (a balance sheet published on its own), Konzernabschluss (consolidated accounts of a group), Tätigkeitsabschluss (only in activity_statements), or null for market data of listed companies.
_provenance.period_start	string \| null	First day of the fiscal period (YYYY-MM-DD); null when unknown, for example for market data.
_provenance.period_end	string \| null	Last day of the fiscal period, the balance sheet date (YYYY-MM-DD); null when unknown.
_provenance.exempt_subsidiary	boolean	true when the company publishes its parent's consolidated accounts with this filing, as an exempt subsidiary: the figures are then the group's, not the company's own. false when the filing is not identified as such.
_provenance.parent_organization	object \| null	{entity_id, name} of the parent when exempt_subsidiary is true, otherwise null. entity_id is null when the parent cannot be identified unambiguously.

Example: for 2023, BioNTech Manufacturing GmbH publishes the consolidated accounts of BioNTech SE.

"_provenance": {
  "statement_type": "Konzernabschluss",
  "period_start": "2023-01-01",
  "period_end": "2023-12-31",
  "exempt_subsidiary": true,
  "parent_organization": {
    "entity_id": "ff3d08559be5e2be873c7d0935062d2f",
    "name": "BioNTech SE"
  }
}

activity_statements: statements per regulated activity (section 6b EnWG)

Max

Energy utilities publish a separate balance sheet and P&L for each regulated activity, such as electricity distribution, together with their annual accounts. With Max, the years of balance_sheet_accounts and profit_and_loss_account contain these activity statements as activity_statements, at no extra credits; a year without any has no such key. Each item holds an account tree like the year itself (balance_sheet_accounts or profit_and_loss_accounts), its own _provenance with statement_type Tätigkeitsabschluss, and activity.name: {de: string, en?: string, in_report: string | null}.

Activity figures do not necessarily add up to the company totals. Balance sheets and P&Ls are separate lists and can cover different activities.

Possible activities (activity.name). The value Andere Tätigkeiten (Other activities) can occur more than once in a year; tell the items apart by in_report.

name.de	name.en
Elektrizitätsverteilung	Electricity distribution
Gasverteilung	Gas distribution
Messstellenbetrieb	Metering point operation
Gasspeicherung	Gas storage
Gasfernleitung	Gas transmission
Elektrizitätsübertragung	Electricity transmission
LNG-Anlagenbetrieb	LNG facility operation
Andere Tätigkeiten	Other activities

annual_financial_statements (5 credits)

Key	Type	Description
[]	array<object>	One entry per published statement.
[].year	number	Fiscal year of the statement.
[].document_type	string	Statement type. Observed values: Jahresabschluss, Konzernabschluss.
[].document_title	string	Title of the document, e.g. "Jahresabschluss zum 31. Dezember 2023".
[].document_date	string	Publication or document date.
[].language	string	Language of the document.
[].document_md	string	Complete statement as Markdown text (suitable for LLM processing).

annual_financial_statements__html (5 credits)

Key	Type	Description
[]	array<object>	Same entries as annual_financial_statements, but with document_html instead of document_md.
[].document_html	string	Complete statement as self-contained renderable HTML.