Values and codes
All fixed values that appear in responses.
This page lists the fixed values that occur in the responses, with their meaning. The lists are open: new values can be added. So treat an unknown value like “other” instead of failing with an error.
Status
The status is in status in the company profile. Signals give it in organization.current_profile.status.code in a coarser form.
| Value | Meaning | Occurs in |
|---|---|---|
| ACTIVE | Active, the company is in the register and operating. | Company profile, Signals |
| INSOLVENT | Insolvent, insolvency proceedings are registered. | Company profile, Signals |
| DISSOLVED | Dissolved, the company is in liquidation. | Company profile |
| TERMINATED | Deleted, the company’s entry in the register has been closed. | Company profile |
| INACTIVE | No longer active. Signals use it for both dissolved and deleted companies. | Signals, Deep Shareholders |
Deleted companies stay available too, with their full history.
Legal forms
The legal form is in legal_form, usually as an abbreviation. It is a text, not a fixed code. These values occur in real responses:
| Value | Legal form | Register |
|---|---|---|
| GmbH | Gesellschaft mit beschränkter Haftung (limited liability company), also the non-profit gGmbH | HRB |
| UG (haftungsbeschränkt) | Unternehmergesellschaft (haftungsbeschränkt), a mini GmbH | HRB |
| gUG (haftungsbeschränkt) | Non-profit Unternehmergesellschaft | HRB |
| AG | Aktiengesellschaft (stock corporation) | HRB |
| SE | European company (Societas Europaea) | HRB |
| KGaA | Kommanditgesellschaft auf Aktien (partnership limited by shares) | HRB |
| GmbH & Co. KGaA | KGaA with a GmbH as general partner | HRB |
| VVaG | Versicherungsverein auf Gegenseitigkeit (mutual insurance association) | HRB |
| KG | Kommanditgesellschaft (limited partnership) | HRA |
| GmbH & Co. KG | KG with a GmbH as Komplementärin, the general partner | HRA |
| UG (haftungsbeschränkt) & Co. KG | KG with a UG as general partner | HRA |
| AG & Co. KG | KG with an AG as general partner | HRA |
| SE & Co. KG | KG with an SE as general partner | HRA |
| OHG | Offene Handelsgesellschaft (general partnership) | HRA |
| GmbH & Co. OHG | OHG with a GmbH as partner | HRA |
| e.K. |
Eingetragener Kaufmann or eingetragene Kauffrau (registered sole trader). Also written as eingetragener Kaufmann (e.K.). |
HRA |
| eG | Eingetragene Genossenschaft (registered cooperative) | GnR |
| PartG | Partnerschaftsgesellschaft, a partnership of liberal professions | PR |
| PartmbB | Partnerschaftsgesellschaft with limited professional liability (PartG mbB) | PR |
| e.V. | Eingetragener Verein (registered association) | VR |
| eGbR | Eingetragene Gesellschaft bürgerlichen Rechts (registered civil-law partnership) | GsR |
| Ltd. | Foreign legal form, here the British Limited with an entry in the German register | HRB |
The same legal form can be spelled differently. So compare tolerantly or map the values to your own list. For filters, search-organizations has its own fixed list in legal_form_code.
Register types and register courts
The register entry is in registration: the register court in court, the register type in register_type and the number in register_number.
| Value | Meaning |
|---|---|
| HRB | Handelsregister (commercial register) division B: corporations such as GmbH, UG, AG, SE and KGaA |
| HRA | Handelsregister division A: sole traders and commercial partnerships such as e.K., OHG and KG |
| GnR | Genossenschaftsregister: registered cooperatives |
| PR | Partnerschaftsregister: professional partnerships |
| VR | Vereinsregister: registered associations |
| GsR | Gesellschaftsregister: registered civil-law partnerships (eGbR), since 2024 |
court names the place of the register court as the register writes it, for example Ansbach, Charlottenburg (Berlin) or Frankfurt/Oder. A register number is only unique together with court and type, for example Ansbach HRB 6089.
In embedded data, for example for the parties to a merger, the court can also appear with its full name, for example Amtsgericht Nürnberg.
Kinds of capital
The kind of registered capital is in capital.current.kind and, for earlier amounts, in capital.history[].value.kind.
| Value | Meaning | Occurs in |
|---|---|---|
| STAMMKAPITAL | Stammkapital (share capital), for example of a GmbH or UG | e.g. GmbH, UG |
| GRUNDKAPITAL | Grundkapital (share capital), for example of a stock corporation | e.g. AG, SE, KGaA |
| LIABILITY_SUM | Haftsumme (liability amount), for example the one set in a cooperative’s statutes | e.g. eG |
| CONDITIONAL | Conditional capital of an AG, in earlier entries | e.g. AG |
Partnerships, sole traders and associations have no registered capital. Then capital.current is null and capital.history is empty.
Roles
A person’s role is in related_persons.current[].label and related_persons.past[].label. role also gives you the role’s name in German and English.
| Value | Meaning |
|---|---|
| MANAGING_DIRECTOR | Managing director (Geschäftsführer or Geschäftsführerin) |
| TEMPORARY_MANAGING_DIRECTOR | Emergency managing director (Notgeschäftsführer), appointed by the court |
| BOARD | Member of the management board (Vorstand) |
| BOARD_CHAIR | Chair of the management board |
| DIRECTOR | Executive director, e.g. of an SE |
| PROCURA | Prokura, the registered power of attorney |
| LIQUIDATOR | Liquidator, winds up a dissolved company |
| INSOLVENCY_ADMINISTRATOR | Insolvency administrator |
| REPRESENTATIVE | Representative or permanent representative, e.g. of a branch |
| FULLY_LIABLE_PARTNER | General partner (persönlich haftender Gesellschafter, Komplementär) |
| LIMITED_PARTNER | Limited partner (Kommanditist), liable only up to their contribution |
| PARTNER | Partner of a PartG. Partners of an OHG have FULLY_LIABLE_PARTNER. |
| OWNER | Owner, e.g. of an e.K. |
| PROPRIETOR | Owner, same meaning as OWNER |
| TREASURER | Treasurer of an association |
| SECRETARY | Secretary of an association |
| YOUTH_WARDEN | Youth warden of an association |
| WATER_WARDEN | Water warden of an association |
| OTHER | Other role |
Signals use almost the same values in parties.role_holder.role.code. Two have different names there: BOARD_MEMBER instead of BOARD and AUTHORIZED_SIGNATORY instead of PROCURA.
For shareholders, the role is in shareholders.entries[].role.label:
| Value | Meaning |
|---|---|
| SHAREHOLDER | Shareholder (Gesellschafter), mainly of a GmbH or UG |
| FULLY_LIABLE_PARTNER | General partner of a KG or OHG |
| LIMITED_PARTNER | Limited partner of a KG |
| PARTNER | Partner of a professional partnership |
| OWNER | Owner of an e.K. |
Signals topics
Every signal belongs to a topic. You find the code in event.topic, the name in event.topic_name. As a filter, pass it in topics exactly like this.
| Value | Topic | Plan |
|---|---|---|
| NEW_REGISTRATIONS | New registrationsCompanies newly registered in the commercial register. | every account |
| MASTER_DATA_CHANGES | Master data changesChanges of company name, seat, business address, or register identity. | every account |
| CLOSURES | Closures & dissolutionsDissolution, liquidation, deletion, or extinguishment of companies. | every account |
| ROLE_HOLDER_CHANGES | Management changesEntries, exits, and changes of managing directors, board members, and holders of procura. | every account |
| CAPITAL_CHANGES | Capital changesChanges to share, liable, conditional, or authorized capital. | every account |
| INSOLVENCIES | InsolvenciesOpenings, protective measures, and terminations of insolvency proceedings. | Pro, Max |
| TRANSFORMATIONS | Transformations & M&AMergers, splits, conversions, asset transfers, enterprise agreements, and squeeze-outs. | Max |
More on topics and filters under signals.
Document types
You pass these values in document_type to fetch-document. What the documents contain is under Documents.
| Value | Document | Format |
|---|---|---|
| AD | Aktueller Abdruck (current printout) | |
| CD | Chronologischer Abdruck (chronological printout) | |
| SI | Strukturierter Registerinhalt (structured register content) | XML |
| shareholders_list | Gesellschafterliste (shareholder list) | |
| articles_of_association | Gesellschaftsvertrag or Satzung (articles of association) |
Industries (WZ)
The industries are in industry_classification: under WZ2008 according to the classification WZ 2008 and under WZ2025 according to WZ 2025. Each entry has a code like 62.20.1 and a German name in label.
Both classifications are published by the Federal Statistical Office (Statistisches Bundesamt). You find all codes with their names on the classification server of the statistical offices of the Federation and the federal states: WZ 2025 and WZ 2008. A company can have several industries.
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}