Insolvenzbekanntmachungen per API: Lieferanten prüfen

Mit der handelsregister.ai API kannst du verfügbare Insolvenzbekanntmachungen zu einer Firma über das Feature insolvency_publications abrufen. Für eine Lieferantenprüfung sind drei Dinge entscheidend: die richtige Gesellschaft, der Inhalt der gerichtlichen Bekanntmachung und ihr zeitlicher Zusammenhang. Eine Meldung ist noch keine abschließende Bewertung des Lieferanten; ein leeres Ergebnis ist kein Bonitätsnachweis.

Dieser Leitfaden zeigt einen Ablauf vom Firmenabgleich bis zur internen Prüfung. Er eignet sich etwa für die Aufnahme eines neuen Lieferanten, eine größere Vorauszahlung oder die erneute Bewertung eines bestehenden Geschäftspartners.

Amtliche Recherche und API: Welche Quelle wofür?

Die gerichtlichen Veröffentlichungen findest du im gemeinsamen Portal für Insolvenzbekanntmachungen. Dort kannst du eine konkrete Bekanntmachung für deine Prüfung recherchieren.

handelsregister.ai ist ein unabhängiger Anbieter. Die API stellt verfügbare Bekanntmachungen im Zusammenhang mit einem Unternehmensprofil strukturiert bereit. Das hilft, Daten in eigene Einkaufs- oder Rechercheabläufe zu übernehmen. Es ist keine amtliche API der Justiz und keine Garantie für eine vollständige oder verzögerungsfreie Erfassung aller Verfahren.

1. Den Lieferanten eindeutig zuordnen

Beginne mit dem rechtlichen Vertragspartner, nicht nur mit einer Marke oder Website. Gleiche Firmenname, Registergericht, Registerart und Registernummer mit deinen Lieferantenstammdaten ab. Prüfe außerdem Sitz und Rechtsform. Zwei Gesellschaften mit ähnlichem Namen sind nicht derselbe Schuldner.

Über search-organizations kannst du Kandidaten suchen. Übernimm die entity_id erst nach dem Abgleich. Verwende sie für spätere Profilabrufe, statt jedes Mal nur nach dem Namen zu suchen.

Auch bei einer korrekt zugeordneten Firma solltest du die Identität in der einzelnen Bekanntmachung prüfen. Dafür stehen unter anderem entity_name, register und seat zur Verfügung. Fehlende oder abweichende Angaben sind ein Anlass zur Klärung.

2. Insolvenzbekanntmachungen gezielt abrufen

Der Endpunkt ist GET /api/v1/fetch-organization. Übergib die geprüfte Firmen-ID als q und fordere insolvency_publications als Feature an. Der API-Key gehört in den Header, nicht in die URL. Parameter und Abrechnung stehen in der Endpunkt-Dokumentation.

Das folgende Python-Beispiel führt einen Profilabruf aus. Installiere dafür requests, hinterlege deinen API-Key als Umgebungsvariable HANDELSREGISTER_API_KEY und ersetze den Platzhalter durch eine bereits geprüfte entity_id.

import os
import requests

entity_id = "HIER_DIE_GEPRUEFTE_ENTITY_ID"

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": os.environ["HANDELSREGISTER_API_KEY"]},
    params={"q": entity_id, "feature": "insolvency_publications"},
    timeout=60,
    allow_redirects=False,
)
if response.status_code != 200:
    raise RuntimeError("Abruf fehlgeschlagen; keine fachliche Bewertung.")

profile = response.json()
if not isinstance(profile, dict) or profile.get("entity_id") != entity_id:
    raise RuntimeError("Firmenzuordnung der Antwort prüfen.")

notices = profile.get("insolvency_publications")
if not isinstance(notices, list):
    raise RuntimeError("Feature fehlt oder ist nicht auswertbar.")

if not notices:
    print("Keine Meldungen geliefert; Bonität bleibt ungeprüft.")
else:
    for notice in notices:
        if not isinstance(notice, dict):
            raise RuntimeError("Unerwartetes Format einer Bekanntmachung.")
        print({
            "datum": notice.get("publication_date"),
            "art": notice.get("publication_label"),
            "gericht": notice.get("court_city"),
            "aktenzeichen": notice.get("insolvency_id"),
        })
        # Für die Prüfung auch Identität und event_notice heranziehen.

Die Unterscheidung im Code ist beabsichtigt: fehlgeschlagener Abruf, nicht auswertbares Feature und erfolgreich gelieferte leere Liste sind verschiedene Ergebnisse. Keines davon darf unbemerkt in „Lieferant unauffällig“ umgewandelt werden.

Den dokumentierten Abruf mit Firmen-ID und Feature haben wir am 17. September 2026 erfolgreich gegen die API geprüft. Das bestätigt die getestete Antwortstruktur, nicht die Vollständigkeit der Daten für jede Firma. Der Abruf kostete bei vorhandenen Bekanntmachungen zehn Credits. Kalkuliere den Basisabruf und angeforderte Features zusammen; die aktuelle Abrechnung steht in der Dokumentation und unter meta.request_credit_cost.

3. Die Felder im Zusammenhang lesen

Die Feldreferenz für Ereignisse und Nachrichten beschreibt diese Struktur. Verwechsle sie nicht mit dem Feature publications: Dieses liefert Registerereignisse unter dem Antwortschlüssel history.

4. Verfahrensschritte auseinanderhalten

Nicht jede Bekanntmachung bedeutet, dass gerade ein neues Insolvenzverfahren eröffnet wurde. Für die interne Weitergabe hilft diese Unterscheidung:

Die gesetzlichen Anknüpfungspunkte sind § 21 InsO zu vorläufigen Maßnahmen, § 27 InsO zum Eröffnungsbeschluss und § 26 InsO zur Abweisung mangels Masse.

Diese Tabelle ist eine Lesehilfe, keine automatische Entscheidungsregel. Ob eine Zahlung, Lieferung oder Vertragsänderung zulässig und sinnvoll ist, folgt nicht aus dem Label allein.

5. Beispiel: Eine Vorauszahlung steht an

Fiktiver Fall: Dein Einkauf prüft vor einer größeren Vorauszahlung einen bestehenden Lieferanten. Die API liefert zwei Bekanntmachungen mit demselben Gericht und Aktenzeichen: eine frühere vorläufige Maßnahme und einen späteren Eröffnungsbeschluss.

Ein brauchbarer interner Hinweis lautet sinngemäß:

Zur zugeordneten Gesellschaft liegen zwei Bekanntmachungen desselben Verfahrens vor. Die spätere betrifft dessen Eröffnung. Bitte den Bekanntmachungstext und die amtliche Quelle prüfen und die geplante Vorauszahlung zur fachlichen Entscheidung vorlegen.

Das beschreibt, was gefunden wurde und welche Entscheidung ansteht. „Zwei Insolvenzen“ wäre dagegen eine falsche Zählung. Auch ein automatischer Zahlungsstopp folgt daraus nicht ohne deine festgelegten Zuständigkeiten und die Prüfung des konkreten Falls.

6. Wiederholte Abrufe nach dem tatsächlichen Bedarf planen

Für ein Lieferantenportfolio bietet sich zunächst eine kleine, fachlich relevante Auswahl an. Lege fest, welche Situation einen neuen Abruf rechtfertigt: etwa eine bevorstehende Vorauszahlung, ein neues größeres Auftragsvolumen oder ein bereits laufender Prüfprozess. Für kritische Lieferbeziehungen kannst du ein begründetes regelmäßiges Intervall festlegen.

Damit wiederholte Ergebnisse nicht jedes Mal dieselbe Aufgabe erzeugen:

• Gruppiere bekannte Meldungen nach Firmen-ID, Gericht und Aktenzeichen.
• Unterscheide einzelne Bekanntmachungen innerhalb eines Verfahrens zusätzlich nach Datum und Inhalt; das Aktenzeichen allein ist keine Meldungs-ID.
• Führe neue oder geänderte Texte zur Prüfung zusammen, statt nur Meldungsanzahlen zu vergleichen.
• Halte Abrufzeit und Veröffentlichungsdatum getrennt. „Heute erstmals gesehen“ bedeutet nicht automatisch „heute veröffentlicht“.

Das ist ein Vorschlag für deine eigene Verarbeitung. Welche Ereignisse natives Monitoring oder Signals abdecken und welche Tarifberechtigungen gelten, solltest du gesondert in der Monitoring-Anleitung prüfen. Setze einen Profilabruf nicht mit einem garantierten Insolvenz-Alarmdienst gleich.

Was ein leeres Ergebnis nicht beantwortet

Ein erfolgreicher Abruf ohne Bekanntmachungen besagt nur, dass dieser Abruf keine solchen Einträge geliefert hat. Er belegt weder Zahlungsfähigkeit noch das Fehlen sämtlicher Insolvenzverfahren.

Auch das amtliche Portal ist kein zeitlich unbegrenztes Archiv: Für Veröffentlichungen gelten Löschungsfristen nach § 3 InsBekV. Daraus folgt kein pauschaler Aufbewahrungszeitraum für deine eigenen Daten; kläre deinen Verwendungszweck und die dafür geltenden Regeln gesondert.

Ebenso ersetzt der Firmenstatus im Handelsregister keine Prüfung konkreter Insolvenzbekanntmachungen. Und ein Jahresabschluss beschreibt eine zurückliegende Berichtsperiode, nicht die Liquidität am heutigen Tag. Weitere Bausteine erklärt unser Leitfaden zur Bonitätsprüfung mit Registerdaten.

Mit einer kleinen Lieferantenliste beginnen

Wähle einige Gesellschaften, für die tatsächlich eine Einkaufsentscheidung ansteht. Ordne sie eindeutig zu, rufe nur die benötigten Features ab und prüfe, ob die Ergebnisse die offene Frage beantworten. Plane erst danach die Verarbeitung für ein größeres Portfolio.

Den ersten Abruf kannst du im API-Playground vorbereiten. Die Parameter und Antwortfelder findest du in der Dokumentation zu fetch-organization. So testest du den Nutzen an einem konkreten Vorgang, bevor du einen wiederkehrenden Ablauf aufbaust.

Quellen, Dokumentation und getestete API-Struktur: Stand 17. September 2026. Entscheidungen über einzelne Verträge, Forderungen oder Zahlungen benötigen eine gesonderte fachliche Prüfung.