Handelsregister API: Firmen suchen, Registerdaten und Gesellschafter abrufen

Beispiel: GmbHs in Berlin suchen

Eine Suche nach Berliner GmbHs mit hinterlegten Abschlüssen sieht so aus. Die Antwort enthält für jede Firma die kanonische company_id, mit der du Details abrufst.

POST /api/enrichments/search_company
Authorization: Bearer eak_...
Content-Type: application/json

{
  "query": "Beratung",
  "page": 1,
  "per_page": 25,
  "filters": {
    "register_type": "HRB",
    "legal_form": "gmbh",
    "state": "Berlin",
    "city": "Berlin",
    "has_financials": true
  }
}

{
  "results": [
    {
      "company_id": "DE-HRB-F1103-267645",
      "legal_name": "Mustermann Beratung GmbH",
      "legal_form": "gmbh",
      "register": {
        "register_type": "HRB",
        "court_code": "F1103",
        "court_name": "Berlin (Charlottenburg)",
        "register_number": "267645"
      },
      "status": "active",
      "state": "Berlin",
      "city": "Berlin",
      "postal_code": "10115",
      "has_financials": true
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total_pages": 1,
    "total_results": 1
  },
  "_registry_meta": {
    "search_scope": "mirror"
  }
}

Felder und Quellen

Was eine Abfrage kostet

Alle Tarife und Abrechnungsregeln stehen auf der Preisseite.

Was die Handelsregister API liefert

Das deutsche Handelsregister ist die amtliche Quelle für Firmenname, Rechtsform, Sitz, Kapital und Vertretungsberechtigte. Skael liest diese Angaben von handelsregister.de, und zwar die strukturierten Registerdaten im Format SI-XML nach XJustiz sowie die hinterlegten Dokumente, und gibt sie als JSON zurück.

Aus einer Abfrage bekommst du den eingetragenen Firmennamen, die Rechtsform, Registerart und Registernummer, die Anschrift, das Stammkapital oder Grundkapital, die aktuellen Vertreter und den Status der Firma. Über weitere Endpunkte rufst du die Gesellschafter aus der aktuellen Gesellschafterliste, die wirtschaftlich Berechtigten und frühere Gesellschafterlisten ab.

Registerdokumente wie den aktuellen Ausdruck, den chronologischen Ausdruck, die Satzung oder die Gesellschafterliste lädst du über einen signierten Link herunter, der 15 Minuten gültig ist und das Dokument als XML oder PDF liefert.

So läuft eine Abfrage

Jede Abfrage ist ein POST an /api/enrichments/{type} mit deinem API-Schlüssel im Authorization-Header. Synchron bekommst du die Antwort direkt im selben Request. Für längere Abfragen stellst du auf asynchron um und holst das Ergebnis per Polling, oder du gibst eine callback_url an und bekommst einen Webhook, sobald das Ergebnis fertig ist. Für mehrere Firmen auf einmal gibt es den Batch-Endpunkt.

Die Suche findet Firmen über den Namen oder nur über Filter: register_type (HRB, HRA, PR, GnR, VR), legal_form, state, city und has_financials schränken das Ergebnis ein. Mit page und per_page blätterst du durch bis zu 100 Treffer pro Seite. Für ein Eingabefeld liefert autocomplete_company ab drei Zeichen bis zu 20 Vorschläge.

Eine Detailabfrage läuft über get_company mit der company_id oder dem Tupel aus Registerart, Gerichtscode und Registernummer. Wurde die Firma in den letzten 30 Tagen schon einmal abgerufen, kommt die Antwort ohne neue Registerabfrage aus dem Bestand und dauert unter einer Sekunde. Sonst fragt Skael das Register live ab, das dauert 5 bis 30 Sekunden.

Grenzen in v1

Die Suche in v1 läuft im Registerbestand von Skael, nicht live auf handelsregister.de. Die Antwort markiert das über _registry_meta.search_scope = mirror. Einen Filter nach Gründungs- oder Eintragungsdatum gibt es in v1 nicht.

Die Handelsregister-Endpunkte laufen als Pilot und werden je Organisation freigeschaltet. Ohne Freischaltung antwortet die API mit 403. Über den MCP-Server kann dein Assistent die Endpunkte ebenfalls aufrufen, sobald sie für deine Organisation freigeschaltet sind.

Dokumentation

• Firmen suchen
• Firmennamen vervollständigen
• Firmenprofil abrufen
• Gesellschafter abrufen
• Registerdokumente laden
• API-Leitfaden

Weitere Datenquellen und Anwendungsfälle

• Firmendaten APIRegisterdaten, Gesellschafter, Jahresabschlüsse und Registerdokumente deutscher Unternehmen als JSON abrufen.
• MCP Server für B2B LeadsGeprüfte B2B Leadlisten direkt aus Claude, ChatGPT, Cursor und Claude Code, eingerichtet in drei Schritten.
• Neugründungen und RegisteränderungenFirmen im Handelsregister nach Rechtsform und Ort finden und Änderungen an bekannten Firmen per Webhook verfolgen.
• Google Maps LeadsFirmen aus Google Maps finden, Impressum und Entscheider lesen und geprüfte Mails als Leadliste bekommen.