aktiv

HALL TABAKWAREN e.K. Automatengeschäft e.K.

Worms ·HRA 40680 Mainz

Teil 1 / 2

Strukturierte Daten

Geparste, typisierte und über die API direkt abfragbare Felder.

Stammdaten

Rechtsform: e.K.
Anschrift: 67547 Worms
Handelsregister: HRA 40680, Mainz
Branche: Branche · mit API-Key einsehbar API-Key holen →

Finanzen

Für dieses Unternehmen sind keine Geschäftszahlen veröffentlicht.

Vertretungsberechtigte

J******* M******* K************* seit 2023 Eigentümer
M****** D** R********** seit 2023 Prokura
M****** S**** seit 2014 Prokura

8 ehemalige Vertretungsberechtigte · mit API-Key einsehbar API-Key holen →

Eigentum & Beteiligungen

Gesellschafter

J****** K****** Eigentümer

Historie

2023
06.10.

Austritt einer Position

J******* M******* K************* · Einzelprokura
06.10.

Eintritt eines Mitglieds

J******* M******* K************* · Inhaber
06.10.

Eintritt eines Mitglieds

M****** D** R********** · Einzelprokura
06.10.

Austritt einer Position

M****** D** R********** · Inhaber
2022
05.04.

Berichtigung personenbezogener Daten

J******* M******* K************* · Einzelprokura
22.03.

Eintritt eines Mitglieds

J******* M******* K************* · Einzelprokura
22.03.

Austritt einer Position

H****** H*** · Prokura
2014
18.12.

Geschäftsübernahme mit Firmenfortführung (§25 HGB)

HALL TABAKWAREN e.K. Automatengeschäft

21 weitere Einträge API-Key holen →

Teil 2 / 2

Rohdaten & Dokumente

Originaldokumente, Markdown-Volltexte und PDFs – Volltext-Zugriff über die API.

Registerdokumente

PDF-Dokumente direkt vom Amtsgericht – auf Anfrage über den :code Endpunkt abrufbar.

Aktueller Auszug (AD)
Chronologischer Auszug (CD)
Strukturierte Inhalte (SI, XML)
Gesellschafterliste
Satzung / Gesellschaftsvertrag

Mit API-Key abrufen API-Key holen →

Website-Inhalt

Strukturierter Markdown-Volltext der Unternehmenswebsite – ideal für Anreicherung und AI-Pipelines.

Website-Snapshot (per AI ermittelt) AI

Mit API-Key abrufen API-Key holen →

Live API

GEThandelsregister.ai/api/v1/fetch-organization

?q=12d26a109d30336e33cf5b4d25ff93c4

&features=related_persons

&features=shareholders

&features=history

curl -H 'X-API-KEY: YOUR_API_KEY' \
  "https://handelsregister.ai/api/v1/fetch-organization?q=12d26a109d30336e33cf5b4d25ff93c4&features=related_persons&features=shareholders&features=history"

# pip install handelsregister
from handelsregister import Handelsregister

client = Handelsregister(api_key="YOUR_API_KEY")  # or set HANDELSREGISTER_API_KEY
organization = client.fetch_organization(
    q="12d26a109d30336e33cf5b4d25ff93c4",
    features=[
        "related_persons",
        "shareholders",
        "history",
    ],
)
print(organization["name"])

// npm install handelsregister
import { Handelsregister } from 'handelsregister';

const client = new Handelsregister('YOUR_API_KEY'); // or set HANDELSREGISTER_API_KEY
const organization = await client.fetchOrganization({
  q: '12d26a109d30336e33cf5b4d25ff93c4',
  features: [
    'related_persons',
    'shareholders',
    'history',
  ],
});
console.log(organization.name);

// npm install handelsregister
const { Handelsregister } = require('handelsregister');

const client = new Handelsregister(process.env.HANDELSREGISTER_API_KEY);
(async () => {
  const organization = await client.fetchOrganization({
    q: '12d26a109d30336e33cf5b4d25ff93c4',
    features: [
      'related_persons',
      'shareholders',
      'history',
    ],
  });
  console.log(organization.name);
})();

{
    "entity_id": "<32-char hex>",
    "name": "<string>",
    "status": "<enum: ACTIVE | TERMINATED | DISSOLVED | INSOLVENT>",
    "legal_form": "<string>",
    "address": {
        "house_number": null,
        "street": null,
        "postal_code": "<string>",
        "city": "<string>",
        "county": "<string>",
        "state": "<string>",
        "country": "<ISO country>",
        "coordinates": null
    },
    "registration": {
        "court": "<string>",
        "register_type": "<string>",
        "register_number": "<string>"
    },
    "registration_date": null,
    "purpose": null,
    "keywords": [],
    "products_and_services": [],
    "contact_data": {
        "website": null,
        "phone_number": null,
        "email": null
    },
    "industry_classification": {
        "redacted": "<bool>"
    },
    "shareholdings": null,
    "annual_financial_statements__html": [],
    "financial_kpi": [],
    "shareholders": {
        "total_capital": null,
        "entries": [
            {
                "shareholder": {
                    "entity_id": null,
                    "first_name": "<string>",
                    "last_name": "<string>",
                    "birth_date": null,
                    "address": null,
                    "redacted": "<bool>"
                },
                "contribution": null,
                "contribution_ratio": null,
                "role": {
                    "label": "<string>",
                    "en": {
                        "long": "<string>",
                        "short": "<string>"
                    },
                    "de": {
                        "long": "<string>",
                        "short": "<string>"
                    }
                },
                "redacted": "<bool>"
            }
        ]
    },
    "profit_and_loss_account": [],
    "ubos": null,
    "balance_sheet_accounts": [],
    "representation_scheme": {
        "current": null,
        "history": []
    },
    "related_persons": {
        "current": [
            {
                "entity_id": null,
                "label": "<string>",
                "role": {
                    "en": {
                        "long": "<string>",
                        "short": "<string>"
                    },
                    "de": {
                        "long": "<string>",
                        "short": "<string>"
                    }
                },
                "name": "<string>",
                "start_date": "<ISO date>",
                "end_date": null,
                "birth_date": null,
                "name_parts": {
                    "given": "<string>",
                    "family": "<string>",
                    "maiden": null,
                    "canonical_name": "<string>",
                    "previous_names": [
                        "<string>"
                    ]
                },
                "titles": [
                    "<string>"
                ],
                "location": {
                    "home": {
                        "city": null
                    }
                },
                "organization_representation_scheme": {
                    "current": null,
                    "history": []
                },
                "role_representation_scheme": {
                    "current": [
                        "<string>"
                    ],
                    "history": [
                        {
                            "value": [
                                "<string>"
                            ],
                            "effective_from": "<string>",
                            "effective_to": "<string>"
                        }
                    ]
                },
                "redacted": "<bool>"
            }
        ],
        "past": [
            {
                "entity_id": null,
                "label": "<string>",
                "role": {
                    "en": {
                        "long": "<string>",
                        "short": "<string>"
                    },
                    "de": {
                        "long": "<string>",
                        "short": "<string>"
                    }
                },
                "name": "<string>",
                "start_date": "<ISO date>",
                "end_date": "<ISO date>",
                "birth_date": null,
                "name_parts": {
                    "given": "<string>",
                    "family": "<string>",
                    "maiden": null,
                    "canonical_name": "<string>",
                    "previous_names": null
                },
                "location": {
                    "home": {
                        "city": null
                    }
                },
                "organization_representation_scheme": {
                    "latest": null,
                    "history": []
                },
                "role_representation_scheme": {
                    "latest": [
                        "<string>"
                    ],
                    "history": [
                        {
                            "value": [
                                "<string>"
                            ],
                            "effective_from": "<string>",
                            "effective_to": "<string>"
                        }
                    ]
                },
                "redacted": "<bool>"
            }
        ]
    },
    "capital": {
        "current": null,
        "history": []
    },
    "history": [
        {
            "entity_type": "<string>",
            "name": {
                "de": "<string>",
                "en": "<string>"
            },
            "description": {
                "short": {
                    "de": "<string>",
                    "en": "<string>"
                }
            },
            "start_date": "<ISO date>",
            "details": {
                "value": {
                    "role": {
                        "name": "<string>",
                        "original_name_source": "<string>",
                        "representation_scheme": [
                            "<string>"
                        ]
                    }
                },
                "linked_entities": {
                    "person": {
                        "name": {
                            "given": "<string>",
                            "family": "<string>"
                        },
                        "redacted": "<bool>"
                    },
                    "organization": {
                        "name": "<string>"
                    }
                }
            }
        }
    ]
}

Basis-Felder

entity_id string

Stabile handelsregister.ai-ID (32-stelliger Hex-String).

name string

Eingetragener Firmenname.

status enum

ACTIVE, TERMINATED, DISSOLVED oder INSOLVENT.

legal_form string

Rechtsform (GmbH, AG, KG, …), sofern vorhanden.

address object

Postanschrift mit street, house_number, postal_code, city, county, state, country und coordinates.

registration object

Registereintrag mit court, register_type und register_number.

registration_date date

Datum der Ersteintragung im Handelsregister (ISO).

purpose string

Unternehmensgegenstand laut Eintragung.

representation_scheme object

Allgemeine Vertretungsregelung: { current: [...], history: [...] } mit effective_from/effective_to je Fassung.

capital object

Eingetragenes Kapital: { current, history }. current enthält amount, currency und kind (STAMMKAPITAL, GRUNDKAPITAL, HAFTSUMME, GENEHMIGTES_KAPITAL, BEDINGTES_KAPITAL, VARIABLES_KAPITAL — offene Liste); jeder history-Eintrag hat value, effective_from und effective_to (null = weiterhin gültig). change_amount eines history-Eintrags ist vorzeichenlos und entspricht nicht immer der Differenz zweier aufeinanderfolgender Beträge — Erhöhungen und Herabsetzungen daher aus den Beträgen ableiten. Personengesellschaften und andere Rechtsträger ohne eingetragenes Kapital liefern current: null und eine leere history.

contact_data object

website, phone_number und email, soweit ermittelbar.

industry_classification object

Branchencodes nach WZ2008 und WZ2025 mit Labels.

keywords array<string>

Stichworte, abgeleitet aus dem Unternehmensgegenstand.

products_and_services array<string>

Produkt- und Dienstleistungsbeschreibungen, soweit ermittelbar.

history array<object>

Chronologisches Protokoll aller Registeränderungen (Name, Sitz, Kapital, Vertretung, …).

features=financial_kpi

financial_kpi array<object>

Pro Geschäftsjahr: revenue, employees, active_total (Bilanzsumme), net_income, material_expenses, personnel_expenses.

features=balance_sheet_accounts

balance_sheet_accounts array<object>

Pro Geschäftsjahr: hierarchische Bilanzpositionen aus dem veröffentlichten Jahresabschluss.

features=profit_and_loss_account

profit_and_loss_account array<object>

Pro Geschäftsjahr: hierarchische Positionen der Gewinn- und Verlustrechnung.

features=related_persons

related_persons object

Vertretungsberechtigte Personen: { current: [...], past: [...] } — Geschäftsführer, Vorstände, Prokuristen. Jede Person enthält organization_representation_scheme und role_representation_scheme (aktuelle Regelung + Historie).

features=shareholders

shareholders object

Gesellschafter: { total_capital, entries: [...], history: { current_as_of, past: [...] } }. Jeder entry enthält shareholder, contribution, contribution_ratio und role; history.past liefert frühere Gesellschafterlisten mit as_of-Datum. total_capital, contribution und contribution_ratio können null sein (z. B. bei Personengesellschaften).

features=ubos

ubos object

Wirtschaftlich Berechtigte: { beneficial_owners, unresolved_beneficial_owners, coverage } gemäß Transparenzregister.

features=shareholdings

shareholdings object

Beteiligungen dieses Unternehmens: { holdings: { current: [...] }, summary }. Jede Beteiligung verlinkt eine andere Organisation per entity_id.

features=publications

publications array<object>

Amtliche Bekanntmachungen aus dem Handelsregister (Datum, Titel, Volltext).

features=annual_financial_statements__html

annual_financial_statements__html array<object>

Veröffentlichte Jahresabschlüsse mit document_html (gerendertes HTML), document_type, document_title, document_date, language und year.

Profil · Finanzen · Personen · Dokumente

Strukturierte Daten und Volltexte – pro Unternehmen

Vom Jahresabschluss als HTML bis zur UBO-Liste: jedes Feld einzeln über den features Parameter aktivierbar. Eine API, alle Daten.

Geschäftszahlen Umsatz, Mitarbeiterzahl, Bilanzsumme, Jahresergebnis pro Geschäftsjahr.
Vertretungsberechtigte Aktuelle und ehemalige Geschäftsführer, Vorstände, Prokuristen mit Rollen und Datumsangaben.
Bekanntmachungen Amtliche Bekanntmachungen aus dem Handelsregister inkl. Datum und Volltext.
Gesellschafter Aktuelle Gesellschafterstruktur mit Beteiligungsquoten und Einlagebeträgen.
Wirtschaftlich Berechtigte (UBOs) Wirtschaftlich Berechtigte gemäß Transparenzregister.
Beteiligungen Beteiligungen dieses Unternehmens an anderen Gesellschaften.
Bilanz Vollständige Bilanzpositionen aus den veröffentlichten Jahresabschlüssen.
Gewinn- und Verlustrechnung GuV-Positionen pro Geschäftsjahr.
Jahresabschlüsse (HTML) Veröffentlichte Jahresabschlüsse als gerendertes HTML.
Insolvenzbekanntmachungen Bekanntmachungen aus den amtlichen Insolvenzregistern.
News Aktuelle Erwähnungen des Unternehmens aus externen Quellen.

Alle Felder mit API-Key freischalten API-Key holen →

Code · AI-Agents · No-Code · Workflows

In jeden Stack einbaubar

Egal ob klassische API, AI-Agent oder No-Code-Tool – diese Daten lassen sich überall andocken.

REST API Einfacher GET-Aufruf mit X-API-KEY Header. Kompatibel mit jedem HTTP-Client. Python Funktioniert mit requests, httpx oder Ihrer bevorzugten Bibliothek. Node.js Standard fetch oder axios – kein zusätzliches SDK erforderlich. MCP Server Direkt in Claude, Cursor oder andere MCP-fähige AI-Clients einbinden. n8n Vorgefertigter Custom Node für Workflow-Automatisierung in n8n. Webhook Aufrufbar aus Zapier, Make oder jeder anderen Webhook-Plattform.

Diese Daten in Ihrer App

Holen Sie sich einen API-Key und verwenden Sie diese strukturierten Handelsregisterdaten direkt aus Ihrer Anwendung – ohne Scraping, ohne PDFs.

API Key holen