Werte und Codes
Alle festen Werte, die in Antworten vorkommen.
Hier stehen die festen Werte, die in den Antworten vorkommen, mit ihrer Bedeutung. Die Listen sind offen: Es können neue Werte dazukommen. Behandle einen unbekannten Wert deshalb wie „sonstiges“, statt mit einem Fehler abzubrechen.
Status
Der Status steht im Firmenprofil in status. Signals nennen ihn in organization.current_profile.status.code in einer gröberen Form.
| Wert | Bedeutung | Vorkommen |
|---|---|---|
| ACTIVE | Aktiv, die Firma ist im Register eingetragen und tätig. | Firmenprofil, Signals |
| INSOLVENT | Insolvent, ein Insolvenzverfahren ist eingetragen. | Firmenprofil, Signals |
| DISSOLVED | Aufgelöst, die Firma ist in Liquidation. | Firmenprofil |
| TERMINATED | Gelöscht, die Firma ist im Register erloschen. | Firmenprofil |
| INACTIVE | Nicht mehr aktiv. Signals fassen damit aufgelöste und gelöschte Firmen zusammen. | Signals, Tiefe Gesellschafter |
Auch gelöschte Firmen bleiben abrufbar, mit ihrer ganzen Historie.
Rechtsformen
Die Rechtsform steht in legal_form, meist als Kurzform. Sie ist ein Text und kein fester Code. Diese Werte kommen in echten Antworten vor:
| Wert | Rechtsform | Register |
|---|---|---|
| GmbH | Gesellschaft mit beschränkter Haftung, auch die gemeinnützige GmbH | HRB |
| UG (haftungsbeschränkt) | Unternehmergesellschaft (haftungsbeschränkt) | HRB |
| gUG (haftungsbeschränkt) | Gemeinnützige Unternehmergesellschaft | HRB |
| AG | Aktiengesellschaft | HRB |
| SE | Europäische Aktiengesellschaft (Societas Europaea) | HRB |
| KGaA | Kommanditgesellschaft auf Aktien | HRB |
| GmbH & Co. KGaA | KGaA mit einer GmbH als persönlich haftender Gesellschafterin | HRB |
| VVaG | Versicherungsverein auf Gegenseitigkeit | HRB |
| KG | Kommanditgesellschaft | HRA |
| GmbH & Co. KG | KG mit einer GmbH als Komplementärin, der persönlich haftenden Gesellschafterin | HRA |
| UG (haftungsbeschränkt) & Co. KG | KG mit einer UG als Komplementärin | HRA |
| AG & Co. KG | KG mit einer AG als Komplementärin | HRA |
| SE & Co. KG | KG mit einer SE als Komplementärin | HRA |
| OHG | Offene Handelsgesellschaft | HRA |
| GmbH & Co. OHG | OHG mit einer GmbH als Gesellschafterin | HRA |
| e.K. |
Eingetragener Kaufmann oder eingetragene Kauffrau. Auch als eingetragener Kaufmann (e.K.) geschrieben. |
HRA |
| eG | Eingetragene Genossenschaft | GnR |
| PartG | Partnerschaftsgesellschaft von Freiberuflern | PR |
| PartmbB | Partnerschaftsgesellschaft mit beschränkter Berufshaftung (PartG mbB) | PR |
| e.V. | Eingetragener Verein | VR |
| eGbR | Eingetragene Gesellschaft bürgerlichen Rechts | GsR |
| Ltd. | Ausländische Rechtsform, hier die britische Limited mit Eintrag im deutschen Register | HRB |
Dieselbe Rechtsform kann unterschiedlich geschrieben sein. Vergleiche deshalb tolerant oder ordne die Werte einer eigenen Liste zu. Für Filter hat search-organizations eine eigene, feste Liste in legal_form_code.
Registerarten und Registergerichte
Der Registereintrag steht in registration: das Registergericht in court, die Registerart in register_type und die Nummer in register_number.
| Wert | Bedeutung |
|---|---|
| HRB | Handelsregister Abteilung B: Kapitalgesellschaften wie GmbH, UG, AG, SE und KGaA |
| HRA | Handelsregister Abteilung A: Einzelkaufleute und Personenhandelsgesellschaften wie e.K., OHG und KG |
| GnR | Genossenschaftsregister: eingetragene Genossenschaften |
| PR | Partnerschaftsregister: Partnerschaftsgesellschaften |
| VR | Vereinsregister: eingetragene Vereine |
| GsR | Gesellschaftsregister: eingetragene Gesellschaften bürgerlichen Rechts, seit 2024 |
court nennt den Ort des Registergerichts, wie das Register ihn schreibt, etwa Ansbach, Charlottenburg (Berlin) oder Frankfurt/Oder. Eine Registernummer ist nur zusammen mit Gericht und Art eindeutig, zum Beispiel Ansbach HRB 6089.
In eingebetteten Angaben, etwa bei den Beteiligten einer Verschmelzung, kann das Gericht auch mit vollem Namen stehen, etwa Amtsgericht Nürnberg.
Kapitalarten
Die Art des eingetragenen Kapitals steht in capital.current.kind und für frühere Stände in capital.history[].value.kind.
| Wert | Bedeutung | Vorkommen |
|---|---|---|
| STAMMKAPITAL | Stammkapital, etwa einer GmbH oder UG | z. B. GmbH, UG |
| GRUNDKAPITAL | Grundkapital, etwa einer Aktiengesellschaft | z. B. AG, SE, KGaA |
| LIABILITY_SUM | Haftsumme, etwa die in der Satzung einer Genossenschaft festgelegte | z. B. eG |
| CONDITIONAL | Bedingtes Kapital einer AG, in früheren Ständen | z. B. AG |
Personengesellschaften, Einzelkaufleute und Vereine haben kein eingetragenes Kapital. Dann ist capital.current null und capital.history leer.
Rollen
Die Rolle einer Person steht in related_persons.current[].label und related_persons.past[].label. Den Namen der Rolle auf Deutsch und Englisch liefert role gleich mit.
| Wert | Bedeutung |
|---|---|
| MANAGING_DIRECTOR | Geschäftsführer oder Geschäftsführerin |
| TEMPORARY_MANAGING_DIRECTOR | Notgeschäftsführer, vom Gericht bestellt |
| BOARD | Mitglied des Vorstands |
| BOARD_CHAIR | Vorsitz des Vorstands |
| DIRECTOR | Geschäftsführender Direktor, z. B. einer SE |
| PROCURA | Prokura, die im Register eingetragene Vollmacht |
| LIQUIDATOR | Liquidator, wickelt eine aufgelöste Firma ab |
| INSOLVENCY_ADMINISTRATOR | Insolvenzverwalter |
| REPRESENTATIVE | Vertreter oder ständiger Vertreter, z. B. einer Zweigniederlassung |
| FULLY_LIABLE_PARTNER | Persönlich haftender Gesellschafter, der Komplementär |
| LIMITED_PARTNER | Kommanditist, haftet nur mit seiner Einlage |
| PARTNER | Partner einer PartG. Gesellschafter einer OHG haben FULLY_LIABLE_PARTNER. |
| OWNER | Inhaber, z. B. eines e.K. |
| PROPRIETOR | Inhaber, gleiche Bedeutung wie OWNER |
| TREASURER | Kassenwart eines Vereins |
| SECRETARY | Schriftführer eines Vereins |
| YOUTH_WARDEN | Jugendwart eines Vereins |
| WATER_WARDEN | Wasserwart eines Vereins |
| OTHER | Andere Rolle |
Signals verwenden in parties.role_holder.role.code fast dieselben Werte. Zwei heißen dort anders: BOARD_MEMBER statt BOARD und AUTHORIZED_SIGNATORY statt PROCURA.
Bei den Gesellschaftern steht die Rolle in shareholders.entries[].role.label:
| Wert | Bedeutung |
|---|---|
| SHAREHOLDER | Gesellschafter, vor allem einer GmbH oder UG |
| FULLY_LIABLE_PARTNER | Persönlich haftender Gesellschafter einer KG oder OHG |
| LIMITED_PARTNER | Kommanditist einer KG |
| PARTNER | Partner einer Partnerschaftsgesellschaft |
| OWNER | Inhaber eines e.K. |
Signals-Themen
Jedes Signal gehört zu einem Thema. Den Code findest du in event.topic, den Namen in event.topic_name. Als Filter gibst du ihn in topics genau so an.
| Wert | Thema | Plan |
|---|---|---|
| NEW_REGISTRATIONS | NeueintragungenNeu ins Handelsregister eingetragene Unternehmen. | jedes Konto |
| MASTER_DATA_CHANGES | StammdatenänderungenÄnderungen von Firmenname, Sitz, Geschäftsanschrift oder Registerzuständigkeit. | jedes Konto |
| CLOSURES | Löschungen & AuflösungenAuflösung, Liquidation, Löschung oder Erlöschen von Unternehmen. | jedes Konto |
| ROLE_HOLDER_CHANGES | FührungswechselEintritte, Austritte und Wechsel von Geschäftsführung, Vorstand und Prokura. | jedes Konto |
| CAPITAL_CHANGES | KapitaländerungenÄnderungen am Stamm-, Grund-, Haft- oder genehmigten Kapital. | jedes Konto |
| INSOLVENCIES | InsolvenzenEröffnungen, Sicherungsmaßnahmen und Beendigungen von Insolvenzverfahren. | Pro, Max |
| TRANSFORMATIONS | Umwandlungen & M&AVerschmelzungen, Spaltungen, Formwechsel, Vermögensübertragungen, Unternehmensverträge und Squeeze-outs. | Max |
Mehr zu Themen und Filtern steht bei signals.
Dokumenttypen
Diese Werte gibst du bei fetch-document in document_type an. Was die Dokumente enthalten, steht unter Dokumente.
| Wert | Dokument | Format |
|---|---|---|
| AD | Aktueller Abdruck | |
| CD | Chronologischer Abdruck | |
| SI | Strukturierter Registerinhalt | XML |
| shareholders_list | Gesellschafterliste | |
| articles_of_association | Gesellschaftsvertrag bzw. Satzung |
Branchen (WZ)
Die Branchen stehen in industry_classification: unter WZ2008 nach der Klassifikation WZ 2008 und unter WZ2025 nach WZ 2025. Jeder Eintrag hat einen code wie 62.20.1 und eine deutsche Bezeichnung in label.
Beide Klassifikationen gibt das Statistische Bundesamt heraus. Alle Codes mit Bezeichnung findest du auf dem Klassifikationsserver der Statistischen Ämter des Bundes und der Länder: WZ 2025 und WZ 2008. Eine Firma kann mehrere Branchen haben.
1{2 "name": "Hetzner Online GmbH",3 "industry_classification": {4 "WZ2008": [5 {6 "code": "62.01.0",7 "label": "Erbringung von Dienstleistungen der Informationstechnologie"8 },9 {10 "code": "63.11.0",11 "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"12 },13 {14 "code": "61.90.0",15 "label": "Telekommunikation, sonstige"16 }17 ],18 "WZ2025": [19 {20 "code": "62.20.1",21 "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"22 },23 {24 "code": "46.50.1",25 "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"26 },27 {28 "code": "62.90.0",29 "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"30 }31 ]32 }33}