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

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; mostly empty in V1.

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 here: names stay hidden (GDPR).

4 Filters, sorting, pages

Arguments of search_companies.

Sorting: sort = { field, descending } over, among others, bilanzsumme, equity_ratio, revenue. Pages: page (from 1), page_size (default 25).

5 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.

6 Example response

This is what a full get_company_details response looks like for a fictional example 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: all values below are fictional and serve only 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 §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":            null
  },
  "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, personalaufwand, abschreibungen, jahresueberschuss, …
    }
  },
  "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": {
      "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": []
}

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.

7 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.