Strukturierte Gesellschafterdaten per API – Beta-Release auf handelsregister.ai

Ab sofort stellt handelsregister.ai die Gesellschafterlisten deutscher Unternehmen als strukturierte Daten bereit. Das neue Beta-Feature liefert Anteilseigner und ihre Beteiligungen maschinenlesbar über die API – ideal für Analysen, Compliance, CRM-Anreicherung und Netzwerkauswertungen.

Warum Gesellschafterdaten entscheidend sind

In Deutschland müssen Kapitalgesellschaften – insbesondere GmbHs – ihre Gesellschafterliste aktuell halten und im Handelsregister hinterlegen. Diese Liste zeigt transparent, wer beteiligt ist und mit welchem Anteil. Für Analyst:innen, Investor:innen, Startups und Beratungen sind das zentrale Informationen, um Eigentums- und Kontrollstrukturen zu verstehen, wirtschaftlich Berechtigte zu identifizieren und Beteiligungsnetzwerke zu erkennen.

Bisher lagen die Informationen meist nur als Dokumente (z. B. PDF) vor. Das erschwert Automatisierung und skaliert schlecht. Mit dem neuen Feature erhältst du dieselben Inhalte strukturiert als JSON – sofort verarbeitbar in deinen Pipelines, ohne manuelles Extrahieren.

Was ist neu?

Strukturierte Gesellschafterdaten sind jetzt über die API abrufbar – maschinenlesbar im JSON-Format unter dem Schlüssel "shareholders" in der Antwort-Entity.
Beta-Status: Die Abdeckung wächst kontinuierlich. Immer mehr Unternehmen werden sukzessive ergänzt, deren Gesellschafter dann verfügbar sind.
Fair Use: Es werden keine API-Credits berechnet, wenn für eine Firma aktuell keine Gesellschafterdaten vorliegen.
Einfache Aktivierung: Das Feature wird wie jedes andere aktiviert – über den feature-Parameter in deinem Request.

So aktivierst du das Feature

Du fügst dem Firmenabruf einfach feature=shareholders hinzu. Beispiel:

GET https://handelsregister.ai/api/v1/fetch-organization?api_key=<API KEY>&q=OroraTech%20GmbH%20aus%20M%C3%BCnchen&feature=shareholders&ai_search=on-default

Die Gesellschafterdaten erscheinen in der Antwort unter dem Schlüssel shareholders. Du kannst das Feature parallel zu anderen Features nutzen – z. B. related_persons (statt „management“) oder balance_sheet_accounts (statt „financials“).

Fair-Use-Hinweis: Ist für die angefragte Organisation noch keine Gesellschafterliste verfügbar, bleibt shareholders leer – und es fallen keine API-Credits an.

Datenmodell: `shareholders` (Beta)

Der shareholders-Block enthält das Stammkapital sowie eine Liste von Einträgen. Jeder Eintrag umfasst:

shareholder – Entweder eine natürliche Person (first_name, last_name, birth_date, address) oder eine juristische Person (entity_name, address, country_code, registration_reference).
contribution – Stammeinlage (Betrag & Währung).
contribution_ratio – Quote der Einlage am gesamten Stammkapital (Dezimalzahl).

Ein vollständiges Beispiel (gekürzt auf den relevanten Firmenkontext, mit vollständiger entries-Liste) sieht so aus:

{
  "name": "OroraTech GmbH",
  "shareholders": {
    "total_capital": {
      "amount": 125193,
      "currency": "EUR"
    },
    "entries": [
      {
        "shareholder": {
          "entity_name": "ConActivity KG",
          "address": "Frankfurt am Main",
          "country_code": "DEU",
          "registration_reference": "Amtsgericht Frankfurt am Main, HRA 30787"
        },
        "contribution": {
          "amount": 13181,
          "currency": "EUR"
        },
        "contribution_ratio": 0.10529
      },
      {
        "shareholder": {
          "entity_name": "Korys Investments N.V.",
          "address": "Halle",
          "country_code": "BEL",
          "registration_reference": "Banque Carrefour des Entreprises, 0871.963.979"
        },
        "contribution": {
          "amount": 12469,
          "currency": "EUR"
        },
        "contribution_ratio": 0.0996
      },
      {
        "shareholder": {
          "entity_name": "Wachstumsfonds Bayern 2 GmbH & Co. KG",
          "address": "Landshut",
          "country_code": "DEU",
          "registration_reference": "Amtsgericht Landshut, HRA 11924"
        },
        "contribution": {
          "amount": 11917,
          "currency": "EUR"
        },
        "contribution_ratio": 0.09519
      },
      {
        "shareholder": {
          "entity_name": "Ananda Impact Fund III GmbH & Co. KG",
          "address": "München",
          "country_code": "DEU",
          "registration_reference": "Amtsgericht München, HRA 107669"
        },
        "contribution": {
          "amount": 11166,
          "currency": "EUR"
        },
        "contribution_ratio": 0.08919
      },
      {
        "shareholder": {
          "entity_name": "Edaphon SRL",
          "address": "Brüssel",
          "country_code": "BEL",
          "registration_reference": "Handelsregister Brüssel, BE 0787.533.694"
        },
        "contribution": {
          "amount": 10695,
          "currency": "EUR"
        },
        "contribution_ratio": 0.08543
      },
      {
        "shareholder": {
          "entity_name": "ECBF I SCSp",
          "address": "Munsbach/Luxemburg",
          "country_code": "LUX",
          "registration_reference": "Registre de Commerce et des Sociétés, B 245576"
        },
        "contribution": {
          "amount": 10445,
          "currency": "EUR"
        },
        "contribution_ratio": 0.08343
      },
      {
        "shareholder": {
          "entity_name": "ScaleUp-Fonds Bayern GmbH & Co. KG",
          "address": "Landshut",
          "country_code": "DEU",
          "registration_reference": "Amtsgericht Landshut, HRA 12153"
        },
        "contribution": {
          "amount": 8886,
          "currency": "EUR"
        },
        "contribution_ratio": 0.07098
      },
      {
        "shareholder": {
          "entity_name": "BNP Paribas Solar Impulse Venture Fund SLP",
          "address": "1 BD Hausmann, 75009 Paris/Frankreich",
          "country_code": "FRA",
          "registration_reference": "Registre national des entreprises, 912 234 911"
        },
        "contribution": {
          "amount": 8018,
          "currency": "EUR"
        },
        "contribution_ratio": 0.06405
      },
      {
        "shareholder": {
          "entity_name": "Gruebler Ventures UG (haftungsbeschränkt)",
          "address": "München",
          "country_code": "DEU",
          "registration_reference": "Amtsgericht München, HRB 243542"
        },
        "contribution": {
          "amount": 7888,
          "currency": "EUR"
        },
        "contribution_ratio": 0.06301
      },
      {
        "shareholder": {
          "entity_name": "Findus Venture GmbH",
          "address": "Goldwörth",
          "country_code": "AUT",
          "registration_reference": "Firmenbuch Wien, FN 493001b"
        },
        "contribution": {
          "amount": 7821,
          "currency": "EUR"
        },
        "contribution_ratio": 0.06247
      },
      {
        "shareholder": {
          "entity_name": "Stoffers Capital UG (haftungsbeschränkt)",
          "address": "München",
          "country_code": "DEU",
          "registration_reference": "Amtsgericht München, HRB 243539"
        },
        "contribution": {
          "amount": 3801,
          "currency": "EUR"
        },
        "contribution_ratio": 0.03036
      },
      {
        "shareholder": {
          "first_name": "Rupert",
          "last_name": "Amann",
          "birth_date": "1993-12-14",
          "address": "München"
        },
        "contribution": {
          "amount": 3722,
          "currency": "EUR"
        },
        "contribution_ratio": 0.02973
      },
      {
        "shareholder": {
          "first_name": "Florian",
          "last_name": "Mauracher",
          "birth_date": "1991-01-21",
          "address": "Kirchheim b. München"
        },
        "contribution": {
          "amount": 3722,
          "currency": "EUR"
        },
        "contribution_ratio": 0.02973
      },
      {
        "shareholder": {
          "entity_name": "OroraTech GmbH",
          "address": "München",
          "country_code": "DEU",
          "registration_reference": "Amtsgericht München, HRB 243843"
        },
        "contribution": {
          "amount": 3299,
          "currency": "EUR"
        },
        "contribution_ratio": 0.02635
      },
      {
        "shareholder": {
          "entity_name": "APEX One Best in Class EuVECA GmbH & Co KG",
          "address": "Wien",
          "country_code": "AUT",
          "registration_reference": "Firmenbuch Wien, FN 559371f"
        },
        "contribution": {
          "amount": 1971,
          "currency": "EUR"
        },
        "contribution_ratio": 0.01574
      },
      {
        "shareholder": {
          "entity_name": "Rabo Ventures B.V.",
          "address": "Utrecht",
          "country_code": "NLD",
          "registration_reference": "Handelsregister der Niederlande, KvK-Nummer 34285559"
        },
        "contribution": {
          "amount": 1872,
          "currency": "EUR"
        },
        "contribution_ratio": 0.01495
      },
      {
        "shareholder": {
          "entity_name": "APEX Ventures EuVECA GmbH & Co. KG",
          "address": "Wien",
          "country_code": "AUT",
          "registration_reference": "Firmenbuch Wien, FN 460075g"
        },
        "contribution": {
          "amount": 1509,
          "currency": "EUR"
        },
        "contribution_ratio": 0.01205
      },
      {
        "shareholder": {
          "first_name": "Clemens",
          "last_name": "Kaiser",
          "birth_date": "1966-05-17",
          "address": "Unterschleißheim, Landkreis München"
        },
        "contribution": {
          "amount": 646,
          "currency": "EUR"
        },
        "contribution_ratio": 0.00516
      },
      {
        "shareholder": {
          "entity_name": "SpaceTec Capital GmbH",
          "address": "München",
          "country_code": "DEU",
          "registration_reference": "Amtsgericht München, HRB 173971"
        },
        "contribution": {
          "amount": 606,
          "currency": "EUR"
        },
        "contribution_ratio": 0.00484
      },
      {
        "shareholder": {
          "first_name": "Ingo",
          "last_name": "Baumann",
          "birth_date": "1971-02-27",
          "address": "Köln-Neustadt/Nord"
        },
        "contribution": {
          "amount": 566,
          "currency": "EUR"
        },
        "contribution_ratio": 0.00452
      },
      {
        "shareholder": {
          "entity_name": "Earth Sciences Foundation",
          "address": "Wilmington",
          "country_code": "USA",
          "registration_reference": "Secretary of State in Delaware Nr. 5787470"
        },
        "contribution": {
          "amount": 492,
          "currency": "EUR"
        },
        "contribution_ratio": 0.00393
      },
      {
        "shareholder": {
          "first_name": "Matthias",
          "last_name": "Wachter",
          "birth_date": "1980-10-01",
          "address": "Berlin"
        },
        "contribution": {
          "amount": 180,
          "currency": "EUR"
        },
        "contribution_ratio": 0.00144
      },
      {
        "shareholder": {
          "first_name": "Viktor",
          "last_name": "Gauk",
          "birth_date": "1982-05-08",
          "address": "München"
        },
        "contribution": {
          "amount": 141,
          "currency": "EUR"
        },
        "contribution_ratio": 0.00113
      },
      {
        "shareholder": {
          "first_name": "Martin",
          "last_name": "Langer",
          "birth_date": "1986-09-24",
          "address": "München"
        },
        "contribution": {
          "amount": 141,
          "currency": "EUR"
        },
        "contribution_ratio": 0.00113
      },
      {
        "shareholder": {
          "first_name": "Axel Justus Oswald",
          "last_name": "Roenneke",
          "birth_date": "1964-10-07",
          "address": "Augsburg"
        },
        "contribution": {
          "amount": 39,
          "currency": "EUR"
        },
        "contribution_ratio": 0.00031
      }
    ]
  }
}

Anwendungsfälle: Was lässt sich damit bauen?

1) Automatisierte Compliance & KYC Prüfe im Onboarding oder periodisch, wer hinter einer Firma steht. Identifiziere wirtschaftlich Berechtigte, dokumentiere Beteiligungsquoten und behalte Strukturänderungen im Blick – ohne Dokumente händisch auszuwerten.

2) Beteiligungs- und Marktanalysen Erkenne Investoren- und Beteiligungsnetzwerke: Welche Kapitalgeber sind in welchen Unternehmen engagiert? Gibt es gemeinsame Gesellschafter zwischen Firmen? Das ermöglicht neue Insights zu Ökosystemen, Corporate-Venturing-Strategien und Konsolidierungstendenzen.

3) CRM- und Lead-Anreicherung Bereichere Kundendaten mit Eigentümerinformationen: Konzernzugehörigkeit, Beteiligungen, potenzielle Cross-Selling-Pfade. So priorisiert dein Team Accounts, die in relevanten Netzwerken verankert sind.

4) Deal-Screening & Due Diligence Vor Partnerschaften, Akquisitionen oder Investments prüfst du Gesellschafterstrukturen auf Knopfdruck. Das spart Zeit, erhöht Konsistenz und schafft Audit-Fähigkeit.

5) Graph-Analysen & Visualisierung Erstelle Netzwerkgraphen aus shareholders.entries: Knoten als Firmen/Personen, Kanten als Beteiligungen mit Gewichtung (contribution_ratio). Ideal für interaktive Explorations-Tools oder interne Research-Dashboards.

Best Practices für die Integration

Feature-Flag konsequent setzen: Aktiviere feature=shareholders in relevanten Abfragen. Dank Fair Use entstehen keine Kosten, wenn (noch) keine Daten vorliegen.
Schema berücksichtigen: In entries.shareholder können natürliche oder juristische Personen stehen. Implementiere eine Typprüfung (z. B. entity_name vs. first_name/last_name).
Quoten & Beträge nutzen: contribution.amount und contribution_ratio erlauben Ranking, Aggregation und Visualisierung.
Kombination mit weiteren Features: Nutze parallel z. B. related_persons (Personen mit Relevanz zum Unternehmen) oder balance_sheet_accounts (Kontensalden aus der Bilanz, sofern verfügbar), um Struktur und Finanzdaten gemeinsam auszuwerten.
Deduplizierung & Normalisierung: Je nach Anwendungsfall kann es sinnvoll sein, Gesellschafter-Namen gegen interne Master-Data zu normalisieren (z. B. Schreibvarianten).
Rechte & Dokumentation: Bei Weitergabe oder Anzeige der Daten intern klare Quellenkennzeichnung und Zeitstempel setzen (z. B. „Abgerufen am …“), um Aktualität und Nachvollziehbarkeit sicherzustellen.

Beta: Datenabdeckung & Fair-Use-Policy

Wachsende Abdeckung: Die strukturierte Gesellschafterdatenbank wird in der Beta kontinuierlich erweitert. Immer mehr Firmen erhalten verfügbare shareholders.
Keine Credits ohne Daten: Bleibt shareholders leer, werden keine API-Credits berechnet. So kannst du das Feature risikofrei produktiv aktivieren.
Feedback willkommen: Als Beta-Feature kann es noch zu Feinjustierungen am Schema kommen. Hinweise aus der Praxis helfen, Erkennung und Strukturangaben weiter zu verbessern.

Fazit

Mit den strukturierten Gesellschafterdaten erschließt handelsregister.ai einen zentralen Baustein für Transparenz in Eigentumsverhältnissen – direkt per API, ohne PDF-Parsing. Vom Compliance-Check über Marktanalysen bis zur Netzwerkvisualisierung: Ein einzelner Request liefert die Basis, um Beteiligungsstrukturen zuverlässig zu verstehen und zu nutzen.

Jetzt ausprobieren: feature=shareholders aktivieren, integrativ mit Features wie related_persons und balance_sheet_accounts einsetzen – und von der Fair-Use-Policy profitieren, wenn für ein Unternehmen noch keine Daten vorliegen. Das Feature ist als Beta verfügbar; die Abdeckung wird fortlaufend ausgebaut.

Strukturierte Gesellschafterdaten als JSON - Handelsregister-API