Stammdaten – Dokumentation | handelsregister.ai

Beispiel

Die Beispiele auf dieser Seite stammen aus einer Beispielanfrage für die Hetzner Online GmbH, Ansbach HRB 6089. Ändert sich ihr Eintrag, liefert deine eigene Anfrage andere Werte.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: DEIN_API_SCHLUESSEL" \
  --data-urlencode 'q=Hetzner Online GmbH'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "DEIN_API_SCHLUESSEL"},
    params={
        "q": "Hetzner Online GmbH",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");

const response = await fetch(url, {
  headers: { "x-api-key": "DEIN_API_SCHLUESSEL" },
});
const data = await response.json();

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "status": "ACTIVE",5  "legal_form": "GmbH",6  "registration": {7    "court": "Ansbach",8    "register_type": "HRB",9    "register_number": "6089"10  },11  "keywords": [12    "Dedicated Server",13    "Cloud Hosting",14    "Webhosting",15    "Colocation",16    "Object Storage",17    "Domainregistrierung",18    "SSL-Zertifikate",19    "Web-Hosting-Unternehmen"20  ],21  "products_and_services": [22    "Dedizierte Root-Server (Dedicated Servers)",23    "Cloud-Server und virtuelle Server",24    "Managed Server",25    "Webhosting (Shared Hosting)",26    "Colocation Rack / Rechenzentrumsflächen",27    "Storage Box / Object Storage / Storage Share",28    "Domain-Registrierung",29    "SSL-Zertifikate",30    "Load Balancer",31    "DNS Console",32    "Registration Robot",33    "Custom Solutions"34  ],35  "industry_classification": {36    "WZ2008": [37      {38        "code": "62.01.0",39        "label": "Erbringung von Dienstleistungen der Informationstechnologie"40      },41      {42        "code": "63.11.0",43        "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"44      },45      {46        "code": "61.90.0",47        "label": "Telekommunikation, sonstige"48      }49    ],50    "WZ2025": [51      {52        "code": "62.20.1",53        "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"54      },55      {56        "code": "46.50.1",57        "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"58      },59      {60        "code": "62.90.0",61        "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"62      }63    ]64  },65  "contact_data": {66    "website": "https://www.hetzner.com/",67    "phone_number": "09831 5050",68    "email": "[email protected]"69  },70  "address": {71    "house_number": "25",72    "street": "Industriestraße",73    "postal_code": "91710",74    "city": "Gunzenhausen",75    "county": "Weißenburg-Gunzenhausen",76    "state": "Bayern",77    "country": "DEU",78    "coordinates": {79      "latitude": 49.12483,80      "longitude": 10.7805281    }82  },83  "seat": {84    "city": "Gunzenhausen"85  },86  "registration_date": null,87  "representation_scheme": {88    "current": [89      "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."90    ],91    "history": [92      {93        "value": [94          "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."95        ],96        "effective_from": "2002-10-15",97        "effective_to": "2015-07-28"98      },99      {100        "value": [101          "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."102        ],103        "effective_from": "2015-07-28",104        "effective_to": null105      }106    ]107  },108  "capital": {109    "current": {110      "amount": 50000,111      "currency": "EUR",112      "kind": "STAMMKAPITAL"113    },114    "history": [115      {116        "value": {117          "amount": 50000,118          "currency": "EUR",119          "kind": "GRUNDKAPITAL"120        },121        "effective_from": "2002-10-15",122        "effective_to": null123      }124    ]125  },126  "purpose": "Die Durchführung von Internet- und Netzwerkdienstleistungen, das Erstellen und Vertreiben von Software, der Handel mit Hard- und Software, der Betrieb einer Werbeagentur,darüber hinaus der Im- und Export von Waren aller Art, soweit sie keiner Einfuhr- oder Ausfuhrbeschränkung unterliegen und soweit keine Genehmigungen erforderlich sind.",127  "meta": {128    "request_credit_cost": 5,129    "credits_remaining": 145130  }131}

200 · Beispielantwort: die Basisdaten der Hetzner Online GmbH, Ansbach HRB 6089

Name und Rechtsform

Name, Rechtsform und Status beschreiben die Firma, die entity_id macht sie eindeutig. Speichere die entity_id, wenn du eine Firma später wieder abrufen, beobachten oder mit eigenen Daten verknüpfen willst.

Feld
Feld	Bedeutung	Beispiel	Verfügbarkeit
entity_idstring	Die ID der Firma bei handelsregister.ai. Speichere sie als Schlüssel in deinen Daten. Im Parameter q trifft sie genau diese Firma.Basisdaten	`"94eb910fef13f94585c48c263fa446d4"`	immer
namestring	Name der Firma, wie er im Register steht, mit Rechtsformzusatz.	`"Hetzner Online GmbH"`	wie oben
legal_formstring	Rechtsform, meist als übliche Abkürzung. Vergleiche ohne Rücksicht auf Groß- und Kleinschreibung, denn die Schreibweise kann leicht abweichen, etwa oHG. Mit AI-Mode kann die ausgeschriebene Form stehen. Die Liste zeigt häufige Werte, es gibt weitere.Werte: `GmbH` Gesellschaft mit beschränkter Haftung, `UG (haftungsbeschränkt)` Unternehmergesellschaft, `AG` Aktiengesellschaft, `SE` Europäische Gesellschaft, `KGaA` Kommanditgesellschaft auf Aktien, `GmbH & Co. KG` KG mit einer GmbH als Komplementärin, `KG` Kommanditgesellschaft, `OHG` Offene Handelsgesellschaft, `e.K.` eingetragener Kaufmann, `eG` eingetragene Genossenschaft, `PartG` Partnerschaftsgesellschaft, auch mit beschränkter Berufshaftung, `e.V.` eingetragener Verein, `eGbR` eingetragene Gesellschaft bürgerlichen Rechts	`"GmbH"`	wie oben
statusstring	Registerstatus der Firma. Weitere Werte sind möglich; behandle unbekannte Werte als „nicht aktiv“.Werte: `ACTIVE` aktiv, `INSOLVENT` in einem Insolvenzverfahren, `DISSOLVED` aufgelöst, in Liquidation, `TERMINATED` im Register gelöscht	`"ACTIVE"`	wie oben

Registereintrag

Registergericht, Registerart und Registernummer bestimmen eine Firma eindeutig. Wir schreiben sie zusammen, in unserem Beispiel als „Ansbach HRB 6089“. In dieser Form kannst du sie auch im Parameter q übergeben.

Feld
Feld	Bedeutung	Beispiel	Verfügbarkeit
registrationobject\|null	Der Registereintrag der Firma.Leer, wenn der AI-Mode eine Firma nur aus Webquellen kennt; ihre entity_id beginnt dann mit AI_TMP_Basisdaten	–	immer
registration.courtstring	Registergericht als Ortsname, ohne „Amtsgericht“, etwa Ansbach oder Charlottenburg (Berlin).	`"Ansbach"`	wie oben
registration.register_typestring	Registerart, also das Register und bei Handelsregistern die Abteilung.Werte: `HRB` Handelsregister B: GmbH, UG, AG, SE, KGaA, `HRA` Handelsregister A: e.K., OHG, KG, GmbH & Co. KG, `GnR` Genossenschaftsregister, `PR` Partnerschaftsregister, `VR` Vereinsregister, `GsR` Gesellschaftsregister für die eGbR	`"HRB"`	wie oben
registration.register_numberstring	Registernummer als Text. Eindeutig nur zusammen mit Registergericht und Registerart.	`"6089"`	wie oben
registration_datestring\|null	Tag der Eintragung in das Register, als Zeitstempel im Format ISO 8601.Leer, wenn das Datum nicht erfasst ist	`"2013-03-18T00:00:00+00:00"`	meist: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG selten: GmbH & Co. KG, e.K.

Eine Registernummer ist nur zusammen mit ihrem Registergericht eindeutig. Dieselbe Nummer kann es bei vielen Gerichten geben.

Anschrift und Sitz

address ist die Geschäftsanschrift, seat der im Register eingetragene Sitz. Beide können auseinanderliegen, etwa wenn eine Firma in München eingetragen ist und in Gauting arbeitet.

Feld
Feld	Bedeutung	Beispiel	Verfügbarkeit
addressobject	Geschäftsanschrift der Firma.Basisdaten	–	immer
address.streetstring\|null	Straße ohne Hausnummer.Leer, wenn die Anschrift nur aus dem Ort besteht	`"Industriestraße"`	meist
address.house_numberstring\|null	Hausnummer als Text, auch mit Zusatz wie „6 a“.Leer, wenn die Anschrift keine Hausnummer enthält	`"25"`	wie oben
address.postal_codestring\|null	Postleitzahl als Text, damit führende Nullen erhalten bleiben.Leer, wenn die Anschrift nur aus dem Ort besteht	`"91710"`	wie oben
address.citystring	Ort der Geschäftsanschrift.	`"Gunzenhausen"`	immer
address.countystring	Landkreis oder kreisfreie Stadt. Fehlt bei manchen Anschriften als Schlüssel.	`"Weißenburg-Gunzenhausen"`	meist
address.statestring	Bundesland. Fehlt bei manchen Anschriften als Schlüssel.	`"Bayern"`	wie oben
address.countrystring	Land als dreistelliger Code nach ISO 3166, etwa DEU. Fehlt bei manchen Anschriften als Schlüssel.	`"DEU"`	wie oben
address.coordinatesobject	Geokoordinaten der Geschäftsanschrift, für Karten und Umkreissuchen.	–	wie oben
address.coordinates.latitudenumber\|null	Breitengrad in Dezimalgrad.Leer, wenn die Anschrift nicht verortet werden konnte	`49.12483`	wie oben
address.coordinates.longitudenumber\|null	Längengrad in Dezimalgrad.Leer, wenn die Anschrift nicht verortet werden konnte	`10.78052`	wie oben
seatobject	Der im Register eingetragene Sitz der Firma.	–	immer
seat.citystring	Ort des Sitzes. Er kann von der Geschäftsanschrift abweichen.	`"Gunzenhausen"`	wie oben

Unternehmensgegenstand und Branche

Der Unternehmensgegenstand steht bei GmbH, UG, AG, SE, KGaA, eG und PartG im Register. GmbH & Co. KG, KG, OHG und Einzelkaufleute tragen keinen Gegenstand ein. Branche, Schlagwörter sowie Produkte und Leistungen gibt es für jede Rechtsform.

Feld
Feld	Bedeutung	Beispiel	Verfügbarkeit
purposestring\|null	Unternehmensgegenstand, wie er im Register steht. Mit AI-Mode steht hier eine kurze Zusammenfassung des Geschäfts, auch für Rechtsformen ohne eingetragenen Gegenstand.Leer, wenn die Rechtsform keinen Gegenstand einträgt, etwa KG, OHG und e.K.Basisdaten	`"Die Durchführung von Internet- und Netzwerkdienstleistun…"`	immer: GmbH, UG, AG, SE, KGaA, eG, PartG nie: GmbH & Co. KG, KG, OHG, e.K.
industry_classificationobject	Branche nach der deutschen Klassifikation der Wirtschaftszweige (WZ), in zwei Fassungen.	–	immer
industry_classification.WZ2025array	Branchencodes nach WZ 2025, der aktuellen Fassung. Diese Codes nutzt auch der Branchenfilter der Suche.Leer, wenn keine Branche zugeordnet werden konnte	–	meist
industry_classification.WZ2025[].codestring	WZ-Code mit fünf Stellen, etwa 62.20.1.	`"62.20.1"`	wie oben
industry_classification.WZ2025[].labelstring	Bezeichnung des Wirtschaftszweigs auf Deutsch.	`"Erbringung von Beratungsleistungen auf dem Gebiet der In…"`	wie oben
industry_classification.WZ2008array	Branchencodes nach der älteren Fassung WZ 2008, für Systeme, die noch damit arbeiten.Leer, wenn keine Zuordnung nach WZ 2008 vorliegt	–	teils
industry_classification.WZ2008[].codestring	WZ-Code mit fünf Stellen nach WZ 2008.	`"62.01.0"`	wie oben
industry_classification.WZ2008[].labelstring	Bezeichnung des Wirtschaftszweigs auf Deutsch.	`"Erbringung von Dienstleistungen der Informationstechnolo…"`	wie oben
keywordsarray	Schlagwörter zum Geschäft der Firma, aus öffentlichen Webquellen ermittelt. Mit AI-Mode ergänzt.Leer, wenn die Firma im Web kaum auftritt	–	wie oben
products_and_servicesarray	Produkte und Leistungen der Firma als Liste, aus öffentlichen Webquellen ermittelt. Mit AI-Mode ergänzt.Leer, wenn die Firma im Web kaum auftritt	–	wie oben

Mit AI-Mode enthält purpose eine kurze Zusammenfassung des Geschäfts statt des Registertexts. Schlagwörter sowie Produkte und Leistungen ergänzt der AI-Mode aus dem Web.

Kapital

Kapitalgesellschaften tragen ihr Stamm- oder Grundkapital ein, jede Änderung mit Datum. current ist der geltende Stand, history der Verlauf in zeitlicher Reihenfolge. Personengesellschaften und Einzelkaufleute haben kein festes Kapital; dort ist current null und history leer.

Feld
Feld	Bedeutung	Beispiel	Verfügbarkeit
capitalobject	Eingetragenes Kapital mit seinem Verlauf.Basisdaten	–	immer
capital.currentobject\|null	Der geltende Kapitalbetrag.Leer, wenn die Rechtsform kein festes Kapital einträgt, etwa KG, OHG, e.K. und PartG	–	immer: GmbH, UG, AG, SE, KGaA selten: eG nie: GmbH & Co. KG, KG, OHG, e.K., PartG
capital.current.amountnumber	Betrag als Zahl, in der Währung von currency.	`50000`	wie oben
capital.current.currencystring	Währung als Code nach ISO 4217, in aller Regel EUR.	`"EUR"`	wie oben
capital.current.kindstring	Art des Kapitals. Weitere Werte sind möglich.Werte: `STAMMKAPITAL` Stammkapital einer GmbH oder UG, `GRUNDKAPITAL` Grundkapital einer AG, SE oder KGaA, `LIABILITY_SUM` Haftsumme, etwa bei einer Genossenschaft, `CONDITIONAL` bedingtes Kapital einer AG, in früheren Ständen	`"STAMMKAPITAL"`	wie oben
capital.historyarray	Alle eingetragenen Stände in zeitlicher Reihenfolge, der geltende eingeschlossen.	–	wie oben
capital.history[].valueobject	Der Stand mit amount, currency und kind, aufgebaut wie current.	–	wie oben
capital.history[].value.change_amountobject	Betrag der Änderung laut Registereintrag, mit amount und currency. Ob das Kapital erhöht oder herabgesetzt wurde, ergibt sich aus dem Vergleich mit dem vorigen Stand.	–	teils: AG, SE, KGaA selten: GmbH, UG, eG nie: GmbH & Co. KG, KG, OHG, e.K., PartG
capital.history[].effective_fromstring\|null	Gültig ab diesem Tag, im Format JJJJ-MM-TT.	`"2002-10-15"`	immer: GmbH, UG, AG, SE, KGaA selten: eG nie: GmbH & Co. KG, KG, OHG, e.K., PartG
capital.history[].effective_tostring\|null	Gültig bis zu diesem Tag.Leer, wenn der Stand noch gilt	`"2005-02-28"`	wie oben

Den Kapitalverlauf lesen wir maschinell aus den Registereinträgen. Wir setzen dafür die neueste Technik ein und investieren viel in die Qualität; einzelne Fehler sind trotzdem möglich.

Vertretungsregelung

Die Vertretungsregelung legt fest, wer die Firma nach außen vertreten darf. Die Antwort enthält sie im Wortlaut des Registers. In unserer Beispielanfrage für die Hetzner Online GmbH nannte die Historie bis zum 28.07.2015 den Vorstand, danach die Geschäftsführer. Die Befugnis einzelner Personen findest du unter Vertretungsbefugnis.

Feld
Feld	Bedeutung	Beispiel	Verfügbarkeit
representation_schemeobject	Allgemeine Vertretungsregelung der Firma mit ihrem Verlauf.Basisdaten	–	immer: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG meist: AG, SE, KGaA, e.K.
representation_scheme.currentarray\|null	Die geltende Regelung als Liste von Textabsätzen, wörtlich aus dem Register.Leer, wenn keine Regelung eingetragen ist	–	wie oben
representation_scheme.historyarray	Alle eingetragenen Fassungen mit ihrer Gültigkeit, die geltende eingeschlossen.	–	wie oben
representation_scheme.history[].valuearray	Der Text dieser Fassung als Liste von Absätzen.	–	wie oben
representation_scheme.history[].effective_fromstring\|null	Gültig ab diesem Tag, im Format JJJJ-MM-TT.	`"2002-10-15"`	wie oben
representation_scheme.history[].effective_tostring\|null	Gültig bis zu diesem Tag.Leer, wenn die Fassung noch gilt	`"2015-07-28"`	wie oben

Mit Echtzeit ist history leer. Die geltende Fassung steht in current.

Kontakt und Web

Kontaktdaten stehen nicht im Register. Wir ermitteln sie aus dem Webauftritt der Firma. Ob es sie gibt, hängt deshalb davon ab, was die Firma im Web veröffentlicht.

Feld
Feld	Bedeutung	Beispiel	Verfügbarkeit
contact_dataobject	Kontaktdaten aus dem Webauftritt der Firma.Basisdaten	–	immer
contact_data.websitestring\|null	Adresse der Website.Leer, wenn keine Website gefunden wurde	`"https://www.hetzner.com/"`	teils
contact_data.phone_numberstring\|null	Telefonnummer, so wie die Firma sie veröffentlicht. Das Format ist nicht vereinheitlicht.Leer, wenn keine Nummer gefunden wurde	`"09831 5050"`	wie oben
contact_data.emailstring\|null	Allgemeine E-Mail-Adresse der Firma.Leer, wenn keine Adresse gefunden wurde	`"[email protected]"`	wie oben
website_contentstring\|null	Der Text der Website als Markdown, etwa für eigene Auswertungen oder ein Sprachmodell. Kommt mit dem Feature website_content, nur zusammen mit AI-Mode und ohne Aufpreis.Leer, wenn keine Website gefunden wurde`website_content`	`"Dedicated Servers, Cloud & Hosting from Germany \| Hetzne…"`	wie oben

Echtzeit

Mit realtime_mode=handelsregister-default fragt die API zusätzlich live beim Handelsregister an. Die Antwort enthält dann die aktuell eingetragenen Personen und _realtime_mode mit dem Ergebnis des Abrufs. Berechnet wird Echtzeit nur, wenn der Abruf gelingt, dann aber unabhängig davon, was er liefert.

Feld
Feld	Bedeutung	Beispiel	Verfügbarkeit
_realtime_modeobject	Ergebnis des Echtzeit-Abrufs. Nur in der Antwort, wenn du realtime_mode angefragt hast.Basisdaten	–	immer
_realtime_mode.modestring	Der angefragte Modus, handelsregister-default.	`"handelsregister-default"`	wie oben
_realtime_mode.statusstring	Ob der Live-Abruf gelungen ist. Bei jedem anderen Wert enthält die Antwort die gespeicherten Daten, und Echtzeit wird nicht berechnet.Werte: `success` Live-Abruf gelungen, die Daten kommen direkt aus dem Handelsregister	`"success"`	wie oben

Ein Echtzeit-Abruf dauert länger, stell den Timeout deines Clients deshalb auf mindestens 120 Sekunden. Gelingt der Live-Abruf nicht, liefert die API die gespeicherten Daten. _realtime_mode.status ist dann nicht success, und Echtzeit wird nicht berechnet. Dauert die Anfrage zu lange, kommt 408 ohne Kosten; versuch es dann später noch einmal.

Weiter

fetch-organization Der Endpunkt, der die Stammdaten liefert, mit Parametern und Fehlern. Personen und Vertretung Geschäftsführung, Prokura und Gesellschafter mit ihren Befugnissen. Grundbegriffe Wie current und history, null und leere Listen zu lesen sind. Datenverfügbarkeit Was das Register je Rechtsform enthält und woher die Daten kommen.