Datenfelder

1 search_companies → Karte

Kompakter Auszug. Codes sind hier bereits als Labels ausgegeben (z. B. GmbH, Oberösterreich).

2 get_company_details → Profil

Das Unternehmen liegt unter result. Hier stehen die Roh-Codes (z. B. legal_form: "GES" = GmbH, bundesland: "O" = Oberösterreich). Die vollständigen Code-Tabellen stehen weiter unten unter Code-Tabellen.

identity · Stammdaten

location · Sitz

company · Eckdaten

size · Größeneinordnung

financials · Finanzdaten

Zuerst die Kopf-Felder, danach die Positionen – jede als Zeitreihe (Jahr → Wert).

Bilanz-Positionen in financials.bilanz

GuV-Positionen in financials.guv · nur bei has_guv

ratios · Kennzahlen

13 Kennzahlen, jede als Zeitreihen-Objekt. Margen- und Renditekennzahlen brauchen eine GuV und bleiben sonst leer.

Jedes Kennzahl-Objekt enthält u. a. latest, latest_year, history (Jahr → Wert), avg_3y/avg_5y, min_5y/max_5y, volatility, trend sowie Wachstumsmaße.

growth · Wachstum

employees · Beschäftigte

filings · Eingereichte Abschlüsse + events

events[] – Registerereignisse; in V1 meist leer.

management · Geschäftsführung

3 get_full_record → voller Datensatz

Enthält alles aus dem Profil plus:

• financials.positions – vollständige 317-Positionen-Taxonomie (jede UGB-Position)
• financials.passthrough – unbekannte Quell-Codes inkl. Historie (verlustfrei)
• financials.completeness – Qualitätsmaß (Positionsanzahl je Jahr)
• financials.guv_years – Liste der Jahre mit GuV
• management.signatories_history – Zeichnungsberechtigte je Jahr
• derivations – metrics_version + Formel-Registry der Kennzahlen

Auch hier gilt: Namen bleiben ausgeblendet (DSGVO).

4 Filter, Sortierung, Seiten

Argumente von search_companies.

Sortierung: sort = { field, descending } über u. a. bilanzsumme, equity_ratio, revenue. Seiten: page (ab 1), page_size (Standard 25).

5 Code-Tabellen

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

Rechtsform: Der granulare Firmenbuch-Code steht im Profil (legal_form). Die GmbH-Familie ist das Präfix GE… (GES ≈ 99,7 %); die Suchkarte labelt das als GmbH.

Größenklasse gkl: W Kleinst/Mikro · K Klein · M Mittel · G Groß.

6 Beispiel-Antwort

So sieht eine vollständige get_company_details-Antwort für ein fiktives Beispielunternehmen aus (gekürzt; Zeitreihen sind exemplarisch). Felder mit null bzw. leere Objekte/Listen sind ebenfalls Teil der Antwort und werden, wo sinnvoll, mitgesendet, damit der Agent den Unterschied zwischen „nicht vorhanden" und „unbekannt" auswerten kann.

Hinweis: alle Werte unten sind frei erfunden und dienen ausschließlich der Darstellung der Struktur.

// Antwort-Umschlag
"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" (siehe §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",           // Mittel
    "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 } }
      // … weitere Bilanzpositionen (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,                  // im Firmenbuch nur lückenhaft
  "management": {
    "n_signatories_latest":    2,
    "signatories_stable_years": 4,
    "primary_manager": {
      "age":         52,
      "birth_year":  1974,            // nur Jahr (DSGVO)
      "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
    }
    // … ältere Abschlüsse, sortiert nach stichtag absteigend
  ],
  "events": []
}

In der Suchkarte (search_companies) sind bereits Codes als Labels aufgelöst (z. B. legal_form: "GmbH", bundesland: "Oberösterreich"). Im vollständigen Profil und im get_full_record stehen die Roh-Codes — die Tabellen oben in §5 erklären die Auflösung.

7 Stand & Gewähr

Jede Antwort trägt provenance.data_version und built_at (Erstellungszeit der ausgelieferten Daten). Die Daten stammen aus dem österreichischen Firmenbuch (BMJ – Justiz, EU High Value Dataset, CC BY 4.0), werden automatisiert verarbeitet und ohne Gewähr auf Richtigkeit, Vollständigkeit und Aktualität bereitgestellt. Maßgeblich ist stets der amtliche Firmenbuchauszug.

Entwickler-Variante dieser Seite: FIELD_REFERENCE.md im Repo.