Data fields

1 search_companies → card

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

2 get_company_details → profile

The company sits under result. The raw codes live here (e.g. legal_form: "GES" = GmbH, bundesland: "O" = Upper Austria). The complete code tables are further down under Code tables.

identity · Master data

location · Registered seat

company · Key facts

size · Size classification

financials · Financial data

Header fields first, then the positions, each as a time series (year → value).

Balance-sheet positions in financials.bilanz

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

Under § 277 UGB, only medium-sized and large corporations are required to publish their profit and loss statement (P&L). What matters is whether at least two of the following thresholds (§ 221 UGB; since 2024) are exceeded on two consecutive balance-sheet dates:

• total assets of €6.25 million
• revenue of €12.5 million
• an average of 50 employees

Small and micro corporations only have to publish 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 remain empty otherwise.

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 financial statements + events

events[]: register events, derived from the daily change feed since 1 July 2026. The official excerpt provides no event log; on every daily update we compare the master data and record deviations as typed events (name_change, seat_change, legal_form_change, management_change, capital_change) with date, description and source. For capital changes additionally capital_from/capital_to, for management changes managers_added/managers_removed (role + name). Two levels: 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 others) reaching back to ~2020. Queryable across companies via list_events (see below).

financial_institution · Regulated financial company

Present only for banks, insurers and similar regulated institutions. The source is the official register (OeNB bank list, linked by company register number; insurers via EIOPA/GLEIF in preparation), no name guessing.

On the search card this is surfaced as the flag is_financial_institution (bool).

industry · Industry (ÖNACE / NACE)

For around 95% of companies, the industry is the official ÖNACE 2025 assignment of 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% (without an official assignment) are classified from the Firmenbuch business line (free text). oenace and nace are built symmetrically and carry the same 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 ends at class level). The original business line is always preserved. Note: this block used to be called branch and was renamed and extended.

Without a business line the rule is: no guessing. Only unambiguous company names are classified (classified_from: name), otherwise industry is empty. The search card surfaces geschaeftszweig, industry_section plus oenace_division/oenace_group (2025) and oenace_division_2008/oenace_group_2008 including their German labels.

Two editions, both searchable. The codes are ÖNACE 2025 (= NACE Rev. 2.1); in addition, the ÖNACE 2008 edition is maintained. The filters oenace_section/oenace_division/oenace_group match both editions, so a query in the older system never comes up empty. Mind the differences: motor-vehicle trade is division 45 in ÖNACE 2008 and split into 46/47 in ÖNACE 2025. The mapping is the official Statistik Austria correspondence table (deterministic). list_sectors shows which divisions occur per edition.

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 incl. history (lossless)
• financials.completeness, quality measure (position count per year)
• financials.guv_years, the years with a P&L
• management.signatories_history, authorized signatories per year
• derivations, metrics_version + formula registry of the ratios

The same rule applies here: officer names are public Firmenbuch data (single-company queries), birth dates at year granularity only.

4 list_events · get_event_stats → change feed (Pro)

Cross-company feed of register changes, the market and deal-sourcing view: "which companies changed management / raised capital / moved their seat, where, since when". For the change history of one known company, get_company_details is enough (field events[]).

list_events · Filters

Returned 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 federal state, for market dashboards ("how many capital increases in Upper Austria this month").

Companies instead of events? To find companies that had an event, with financial context and ranked by size, use the event_signal filter in search_companies (see section 5). The triggering events are then attached 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; requires a multi-year P&L, otherwise ranked last) (or distance for a radius search). Default: total assets descending. An unknown sort field is rejected together with the list of valid fields. Pages: page (from 1), page_size (default 25).

6 Code tables

Federal state (code → plain name): B Burgenland · K Kärnten (Carinthia) · N Niederösterreich (Lower Austria) · O Oberösterreich (Upper Austria) · S Salzburg · St Steiermark (Styria) · T Tirol (Tyrol) · V Vorarlberg · W Wien (Vienna).

Legal form: the granular Firmenbuch code sits in the profile (legal_form). The GmbH family is the prefix GE… excluding GEN (GES ≈ 99.7%); the search card labels it as GmbH. GEN is the cooperative (labelled eGen) and is not part of the GmbH filter.

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

7 Example response

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

Note: this example is a sample record to illustrate 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 section 6)
    "status":      "active",
    "court":       null
  },
  "location": {
    "country":     "AUT",
    "bundesland":  "O",             // Oberösterreich (Upper Austria)
    "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 } }
      // … further 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 method instead: "rohergebnis" instead 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 sparsely 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 financial statements, sorted by stichtag descending
  ],
  "events": [],
  "industry": {                              // industry, derived from the business line
    "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"
    },
    "oenace_2008": {                          // ÖNACE 2008 twin, symmetric, also searchable
      "section":           "M",
      "division":          "70",
      "division_label_de": "Verwaltung und Führung von Unternehmen; Unternehmensberatung",
      "group":             "70.2",
      "class":             "70.22",
      "version":           "OENACE_2008"
    },
    "code_2008":       "70.22",       // assigned ÖNACE 2008 class
    "source":          "llm",          // or "lexicon"
    "classified_from": "geschaeftszweig"  // or "name"
  }
}

On the search card (search_companies), codes are already resolved to labels (e.g. legal_form: "GmbH", bundesland: "Oberösterreich"). The full profile and get_full_record carry the raw codes; the tables above in section 6 explain the resolution.

8 Freshness & disclaimer

Every response carries provenance.data_version and built_at (build time of the served 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 excerpt always prevails.

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