Data fields

1 search_companies → card

Compact extract. Codes are already resolved to labels here (e.g. GmbH, Oberösterreich).

2 get_company_details → profile

The company sits under result. Raw codes are returned here (e.g. legal_form: "GES" = GmbH, bundesland: "O" = Oberösterreich). The full code tables are further down under Code tables.

identity · Master data

location · Registered seat

company · Key data

size · Size classification

financials · Financial data

First the header fields, then the positions – each as a time series (year → value).

Balance-sheet positions in financials.bilanz

P&L positions in financials.guv · only when has_guv (~3% of companies)

Under § 277 UGB, only medium-sized and large capital companies are required to disclose the profit-and-loss statement (P&L). The decisive question is whether at least two of the following thresholds (§ 221 UGB; since 2024) are exceeded on two consecutive balance-sheet dates:

• balance-sheet total of €6.25 million
• revenue of €12.5 million
• 50 employees on average

Small and micro capital companies are required to disclose only the balance sheet under § 278 UGB.

ratios · Financial ratios

13 ratios, each as a time-series object. Margin and return ratios require a P&L and otherwise stay empty.

Each ratio object contains, among others, latest, latest_year, history (year → value), avg_3y/avg_5y, min_5y/max_5y, volatility, trend as well as growth measures.

growth · Growth

employees · Employees

filings · Filed annual statements + events

events[] – register events (Vollzüge), derived from the daily change feed from 1 July 2026. The official extract carries no change log, so on every daily update we compare the master data and record differences as typed events (name_change, seat_change, legal_form_change, management_change, capital_change) with date, description and source. Capital changes also carry capital_from/capital_to, management changes managers_added/managers_removed (role + name). Two layers: the detailed events (with before/after) are recorded from 1 July 2026; in addition there are coarser historical register events (type + date only, source=change_feed: founding, deletion, merger, split, conversion, capital_change, legal_form_change, and more) back to ~2020. Queryable across companies via list_events (see below).

financial_institution · Regulated financial institution

Present only for banks, insurers and similar regulated institutions. Sourced from the official register (OeNB bank list, joined by company-register number; insurers via EIOPA/GLEIF in progress) – no name guessing.

The search card additionally carries the is_financial_institution flag (bool).

industry · Industry (ÖNACE / NACE)

For roughly 95% of companies the industry is the official ÖNACE 2025 assignment from the register (Statistik Austria open HVD dataset, source = register) — deterministic, updated monthly, with the full path down to the 5-digit subclass. Only the remaining ~5% (with no official assignment) are classified from the free-text Firmenbuch Geschäftszweig. oenace and nace are structurally symmetric and carry identical codes by construction (ÖNACE 2025 = EU NACE Rev. 2.1); ÖNACE with German and English titles, NACE with the official English ones (NACE has no national subclass and stops at class level). The original activity text is always kept. Note: this block was previously called branch; it was renamed and extended.

Without a Geschäftszweig, nothing is guessed: only unambiguous company names are classified (classified_from: name), otherwise industry stays empty. The search card carries geschaeftszweig, industry_section and oenace_division/oenace_group with German labels.

management · Management

3 get_full_record → full record

Contains everything from the profile plus:

• financials.positions – the complete 317-position taxonomy (every UGB position)
• financials.passthrough – unknown source codes including history (lossless)
• financials.completeness – quality measure (position count per year)
• financials.guv_years – list of years with a P&L
• management.signatories_history – authorised signatories per year
• derivations – metrics_version + formula registry of the ratios

Same rule here: officer names are public Firmenbuch data (per-query), birth data year-granular only.

4 list_events · get_event_stats → change feed (Pro)

Cross-company feed of register changes – the market-watch / deal-sourcing view: "which companies changed management / raised capital / relocated – where, since when". For the change history of one known company, use get_company_details (field events[]).

list_events · filters

Per event: fnr, name, date, type, description, for capital capital_from/capital_to, for management managers_added/managers_removed (role + name), plus bundesland, legal_form, industry_section. Sorted by date (newest first).

get_event_stats returns, for the same filters, counts by type and by Bundesland – for market dashboards ("how many capital increases in Upper Austria this month").

Companies rather than events? To find companies that had an event – with financial context, ranked by size – use the event_signal filter in search_companies (see section 5). The triggering events then attach to each company card.

5 Filters, sorting, pages

Arguments of search_companies.

Sorting: sort = { field, descending } over bilanzsumme, revenue, equity_ratio, employees, last_filing_year, revenue_growth_1y, revenue_growth_3y, revenue_growth_5y (revenue growth: 1-year, 3- and 5-year CAGR; only where a multi-year GuV exists, others sort last) (or distance with a near filter). Default: Bilanzsumme descending. An unknown sort field is rejected with the list of valid fields. Pages: page (from 1), page_size (default 25).

6 Code tables

Bundesland (code → plain name): B Burgenland · K Kärnten · N Niederösterreich · O Oberösterreich · S Salzburg · St Steiermark · T Tirol · V Vorarlberg · W Wien.

Legal form: The granular Firmenbuch code is in the profile (legal_form). The GmbH family is the prefix GE… (GES ≈ 99.7%); the search card labels it as GmbH.

Size class gkl: W micro · K small · M medium · G large.

7 Example response

This is what a full get_company_details response looks like for a sample company (abbreviated; time series are illustrative). Fields with null or empty objects/lists are also part of the response and are sent where useful, so the agent can tell the difference between "not present" and "unknown".

Note: this example is a sample record illustrating the structure.

// Response envelope
"schema_version": "1.0",
"data_version": "2026-06-27",
"provenance": {
  "source":        "Österreichisches Firmenbuch / BMJ – Justiz",
  "license":       "CC BY 4.0",
  "data_version":  "2026-06-27",
  "schema_version": "1.0",
  "built_at":      "2026-06-27T07:32:14Z"
},
"result": {
  "identity": {
    "fnr":         "999999x",
    "register_id": "AT_999999x",
    "name":        "Beispiel Industrie GmbH",
    "legal_form":  "GES",           // code → label "GmbH" (see §5)
    "status":      "active",
    "court":       null
  },
  "location": {
    "country":     "AUT",
    "bundesland":  "O",             // Oberösterreich
    "city":        "Linz",
    "postal_code": "4020",
    "street":      null
  },
  "company": {
    "stammkapital":           35000,
    "first_filing_year":      2014,
    "last_filing_year":       2024,
    "filing_years_available": 11,
    "founded_year":           2013,
    "founded_source":         "first_filing-1",
    "description":            "Unternehmensberatung"
  },
  "size": {
    "gkl":               "M",           // medium
    "bilanzsumme_band":  "large",
    "peer_percentiles": {
      "bilanzsumme":    82.4,
      "equity_ratio":   71.3,
      "revenue":        68.9
    }
  },
  "financials": {
    "latest_year":     2024,
    "has_guv_latest":  true,
    "revenue_basis":   "umsatzerloese",
    "latest": {
      "bilanzsumme":    12450000,
      "eigenkapital":   5230000,
      "umsatzerloese":  18900000,
      "ebit":           1430000,
      "ebitda":         2210000,
      "jahresueberschuss": 980000
    },
    "bilanz": {
      "bilanzsumme": {
        "latest":      12450000,
        "latest_year": 2024,
        "history":     { "2022": 10840000, "2023": 11620000, "2024": 12450000 }
      },
      "eigenkapital":    { "latest": 5230000,  "history": { "2022": 4380000, "2023": 4790000, "2024": 5230000 } }
      // … more balance-sheet positions (verbindlichkeiten, anlagevermoegen, vorraete, cash, …)
    },
    "guv": {
      "umsatzerloese":  { "latest": 18900000, "history": { "2022": 16200000, "2023": 17550000, "2024": 18900000 } },
      "ebit":           { "latest": 1430000,  "history": { "2022": 1180000, "2023": 1290000, "2024": 1430000 } }
      "materialaufwand":   { "latest": -9100000 },
      "personalaufwand":   { "latest": -5200000 },
      "abschreibungen":    { "latest": -780000 },
      "ebitda":            { "latest": 2210000 },
      "jahresueberschuss": { "latest": 980000 }
      // cost-of-sales format instead: "rohergebnis" in place of umsatzerloese + materialaufwand
    }
  },
  "ratios": {
    "equity_ratio": {
      "latest":        0.42,
      "latest_year":   2024,
      "history":       { "2022": 0.404, "2023": 0.412, "2024": 0.42 },
      "avg_3y":        0.412,
      "min_5y":        0.39,
      "max_5y":        0.42,
      "trend":         "rising",
      "growth_1y":     0.019,
      "growth_3y_cagr": 0.021
    },
    "ebit_margin":  { "latest": 0.076, "trend": "stable" }
    // … debt_ratio, debt_to_equity, working_capital_ratio, anlagedeckungsgrad_1,
    //    ebitda_margin, net_margin, personalkostenquote, materialaufwandsquote,
    //    roa, roe, capital_profile
  },
  "growth": {
    "profile": "growing",
    "method":  "revenue_3y_cagr"
  },
  "employees": null,                  // only sporadically recorded in the Firmenbuch
  "management": {
    "n_signatories_latest":    2,
    "signatories_stable_years": 4,
    "primary_manager_name":    "Maria Beispiel",   // public Firmenbuch data (name served)
    "primary_manager": {
      "age":         52,
      "birth_year":  1974,            // year only (GDPR)
      "role_label":  "GESCHÄFTSFÜHRER/IN (handelsrechtlich)",
      "vertretung":  "selbständig"
    }
  },
  "filings": [
    {
      "stichtag":     "2024-12-31",
      "format":       "jab40_semantic",
      "parsed":       true,
      "gkl":          "M",
      "eingereicht":  "2025-08-12",
      "document_url": "https://justizonline.gv.at/…",
      "pdf_doc_key":  null
    }
    // … older statements, sorted by stichtag descending
  ],
  "events": [],
  "industry": {                              // industry – derived from the Geschäftszweig
    "geschaeftszweig": "Unternehmensberatung",
    "oenace": {                              // ÖNACE 2025 (national), titles DE + EN
      "section":           "N",
      "section_label_de":  "Erbringung von freiberuflichen, wissenschaftlichen und technischen Dienstleistungen",
      "section_label_en":  "Professional, scientific and technical activities",
      "division":          "70",
      "division_label_de": "Verwaltung und Führung von Unternehmen; Unternehmensberatung",
      "division_label_en": "Activities of head offices and management consultancy",
      "group":             "70.2",
      "group_label_de":    "Unternehmensberatung",
      "group_label_en":    "Business and other management consultancy activities",
      "version":           "OENACE_2025"
    },
    "nace": {                                // EU NACE Rev. 2.1 – same codes, English titles
      "section":        "N",
      "section_label":  "Professional, scientific and technical activities",
      "division":       "70",
      "division_label": "Activities of head offices and management consultancy",
      "group":          "70.2",
      "group_label":    "Business and other management consultancy activities",
      "version":        "NACE_REV_2.1"
    },
    "code_2008":       "70.22",       // assigned ÖNACE 2008 class
    "source":          "llm",          // or "lexicon"
    "classified_from": "geschaeftszweig"  // or "name"
  }
}

In the search card (search_companies) codes are already resolved to labels (e.g. legal_form: "GmbH", bundesland: "Oberösterreich"). In the full profile and in get_full_record the raw codes are returned; the tables above in §5 explain the resolution.

8 Status & warranty

Every response carries provenance.data_version and built_at (build time of the delivered data). The data comes from the Austrian Firmenbuch (BMJ – Justiz, EU High Value Dataset, CC BY 4.0), is processed automatically and provided without warranty as to accuracy, completeness or timeliness. The official Firmenbuch extract is always authoritative.

Developer variant of this page: FIELD_REFERENCE.md in the repo.