Suche nach Informationen zu Geschäftspartnern direkt im Dashboard Insolvenzliste auf der Website iMSiG.pl ist bei Einzelfällen praktisch.
Bei größerem Umfang (z. B. Hunderten oder Tausenden von Geschäftspartnern, der Integration mit CRM- oder Inkassosystemen) wird die manuelle Bearbeitung jedoch ineffizient.
In solchen Fällen empfehlen wir die Nutzung der API, die Folgendes ermöglicht:
- automatische Überprüfung des Status von Schuldnern,
- regelmäßiges Abrufen von Anzeigeninhalten,
- Datenintegration mit internen Systemen (CRM, ERP, Inkassosysteme).
In dieser Anleitung erfahren Sie, wie Sie den vollständigen Wortlaut von Insolvenz- und Sanierungsbekanntmachungen für einen bestimmten Schuldner anhand von Registrierungsnummern (NIP, KRS, REGON, PESEL) abrufen können.
Was ist die Insolvenz-API?
Eine API (Application Programming Interface) ist eine Anwendungsprogrammierschnittstelle, d. h. eine Reihe von Regeln und Protokollen, die es verschiedenen IT-Systemen ermöglichen, direkt miteinander zu kommunizieren.
Es fungiert als„digitale Brücke“, die es Ihrer Software (z. B. CRM oder ERP) ermöglicht, die Funktionen und Ressourcen der MGBI-Datenbank automatisch und ohne manuelles Eingreifen zu nutzen.
Die API-Funktionsweise lässt sich mit einem Schalter in einer Behörde vergleichen, an dem Ihr System die Identifikationsnummer des Schuldners „angibt“ und daraufhin sofort einen vollständigen Satz von Dokumenten erhält.
Autorisierungsschlüssel
Jede API-Anfrage muss authentifiziert werden. Dazu dient ein eindeutiger API-Schlüssel (Autorisierungsschlüssel/Token), der dein Abonnement identifiziert und die verfügbaren Anfrage-Limits kontrolliert.
Um einen API-Schlüssel zu erhalten, melden Sie sich auf der Website iMSiG.plan, gehen Sie auf den Reiter „Insolvenzliste“ und öffnen Sie anschließend „Dienstparameter“.
Unten auf der Seite findest du im Abschnitt„API“deinen Autorisierungsschlüssel sowie einen Link zur vollständigen Dokumentation („API-Version“).
Bitte beachte, dass der API-Schlüssel für alle Nutzer innerhalb eines Abonnements gleich ist, was bedeutet, dass das Hauptkonto und alle Unterkonten denselben Schlüssel (Token) verwenden.
Abruf von Schuldneranzeigen
Das Abrufen der Anzeigeninhalte erfolgt über GET-Anfragen (die zum Auslesen von Daten dienen), die an den entsprechenden API-Endpunkt gesendet werden.
1. Primärer Endpunkt
GET /v2/announcements
Der oben genannte Endpunkt dient zum Suchen und Abrufen von Bekanntmachungen aus dem Gerichts- und Wirtschaftsanzeiger (MSiG) sowie aus dem Nationalen Schuldnerregister (KRZ).
Eine detaillierte Beschreibung der Parameter findest du in der technischen Dokumentation: Insolvenzliste – API-Dokumentation.
2. Schuldner-ID
Um die Bekanntmachungen zu einem bestimmten Unternehmen abzurufen, müssen Sie mindestens eine Identifikationsnummer angeben:
- „nip=“ – Steueridentifikationsnummer (z. B. 5213482472).
- "pesel=" – PESEL-Nummer (natürliche Personen, einschließlich Privatinsolvenz).
- „krs=“ – Nummer im Landesgerichtsregister (Gesellschaften, Stiftungen, Vereine),
- "regon=" – REGON-Nummer (9- oder 14-stellig),
3. Wichtiger Parameter: append_first_entry
Im „Monitor Sądowy i Gospodarczy“ werden die Identifikationsnummern des Schuldners (NIP, KRS, REGON) häufig nur in der ersten Bekanntmachung zu einem bestimmten Fall angegeben.
Zukünftige Bekanntmachungen (z. B. über den Tilgungsplan oder den Wechsel des Insolvenzverwalters) enthalten möglicherweise keine Identifikationsnummern mehr.
Daher muss in der Abfrage unbedingt der folgende Parameter festgelegt werden:
append_first_entry=true
Auf diese Weise findet die API die erste Bekanntmachung in der Sache, identifiziert anhand dieser den Schuldner und gibt alle mit diesem Verfahren verbundenen Bekanntmachungen zurück, auch wenn diese keine Kennung im Text enthalten.
Ohne diesen Parameter könnte die Antwort unvollständig sein.
4. Beispielanfrage
Nehmen wir an, Sie möchten Insolvenz- und Sanierungsbekanntmachungen zu einem Unternehmen anhand der Steuernummer abrufen.
Die HTTP-Anfrage sollte wie folgt aussehen:
GET /v2/announcements?nip=1234567890&append_first_entry=true HTTP/1.1
Host: api.imsig.pl
Authorization: [Autorisierungsschlüssel]
Ebenso kannst du anstelle des Parameters„nip=“ auch „krs=“,„regon=“ oder„pesel=“ verwenden.
Datenstruktur
Die API liefert die Daten in einem strukturierten JSON-Format, wodurch sie in beliebigen IT-Systemen automatisch verarbeitet werden können.
Die wichtigsten Abschnitte der Antwort
In der API-Antwort lassen sich folgende Datengruppen unterscheiden:
- id – eindeutige Kennung der Anzeige in der MGBI-Datenbank
- Eintrag – technische Informationen zum Datensatz, u. a. das Veröffentlichungsdatum sowie das Datum der ersten und letzten Aktualisierung des Eintrags im System.
- Unternehmen – detaillierte Angaben zu dem (den) betroffenen Unternehmen: Name, Rechtsform, PKD-Code und Anschrift des Firmensitzes.
- Verfahren – Einzelheiten zum Gerichtsverfahren: Name des Gerichts, Aktenzeichen sowie Angaben zum Insolvenzverwalter oder Treuhänder (Name oder Vor- und Nachname, Funktion).
- Anordnung– Angaben zu einer bestimmten gerichtlichen Entscheidung, z. B. deren Datum.
- krz_entry / msig_entry – detaillierte Parameter der Veröffentlichung je nach Quelle (Kapitel, Abschnitt, Link zur ursprünglichen Bekanntmachung auf dem Regierungsportal).
- Inhalt – Der vollständige Text der Anzeige wird in zwei Formaten bereitgestellt: als Text und als HTML.
Eine vollständige Liste und Beschreibung der Felder findest du in der API-Dokumentation im Abschnitt „GET /v2/announcements“: Siehe Dokumentation
HTTP-Antwortcodes
Die häufigsten Antwortcodes, die Ihr System verarbeiten sollte:
- 200 (Erfolg): Die Anfrage wurde erfolgreich ausgeführt.
- 401 / 403 (Autorisierungsfehler): Ungültiger oder fehlender API-Schlüssel.
- 429 (Limit überschritten): Du hast dein gesamtes Kontingent an Abfragen für diesen Monat aufgebraucht.
Beispielantwort
{
"id": "651d667e2323c65e8e17e295",
"meta": {
"issue_date": "2023-10-04",
"category": "K.0.3.16",
"first_update_date": "2023-10-04",
"last_update_date": "2023-11-05",
"is_administrator_data_consistent": true,
"is_correction": false,
"is_entity_data_consistent": true
},
"entity": [
{
"info": {
"cleaned_name": "VB Leasing SA",
"legal_form": "spółki akcyjne",
"ownership_type": "własność prywatna krajowa pozostała",
"primary_business": "64.91.Z Leasing finansowy",
"commencement_date": "2008-04-02"
},
"numbers": {
"nip": "5213482474",
"regon": "141374292",
"krs": "0000307665"
},
"address": {
"state": "dolnośląskie",
"powiat": "Wrocław",
"gmina": "Wrocław-Fabryczna",
"town": "Wrocław",
"street": "ul. Fabryczna",
"house_number": "6",
"zip_code": "53-609"
}
}
],
"proceeding": {
"court_name": "Sąd Rejonowy dla Wrocławia-Fabrycznej we Wrocławiu",
"court_department": "VIII Wydział Gospodarczy",
"signatures": [
"WR1F/GR/16/2023",
"WR1F/GRs/5/2023"
],
"administrator_name": "Ams Restrukturyzacje sp. z o.o.",
"administrator_function": "syndyk",
"administrator_address": "ul. Pawła Włodkowica 10 lok. 3",
"administrator_zip_code": "50-072","administrator_town": "Wrocław"
},
"order": {},
"krz_entry": {
"chapter": 0,
"section": 3,
"subsection": 16,
"signature": "20231004/00341",
"issue_date": "2023-10-04",
"url": "https://krz.ms.gov.pl/#!/application/KRZPortalPUB/1.4/KrzRejPubGui.SzczegolyObwieszczenia?params=JTdCJTIyaWRaZXduZXRyem55JTIyJTNBJTIyZWMzYTllODctOTljZC00YTg2LTljNzQtOThkZDQxZmI1MjFhJTIyJTdE"
},
"content": {
"text": "Sąd Rejonowy dla Wrocławia-Fabrycznej we Wrocławiu, VIII Wydział Gospodarczy, ul. Poznańska 16, 53-630 Wrocław, obwieszcza, że Postanowienie Sądu o otwarciu postępowania sanacyjnego wydane w postępowaniu WR1F/GR/16/2023, w dniu 25 lipca 2023 r., o oznaczeniu WR1F/GR/16/2023/39, w zakresie rozstrzygnięcia w przedmiocie otwarcia postępowania restrukturyzacyjnego jest prawomocne z dniem 25 lipca 2023 r.",
"html": "Sąd Rejonowy dla Wrocławia-Fabrycznej we Wrocławiu, VIII Wydział Gospodarczy, ul. Poznańska 16, 53-630 Wrocław, obwieszcza, że Postanowienie Sądu o otwarciu postępowania sanacyjnego wydane w postępowaniu WR1F/GR/16/2023, w dniu 25 lipca 2023 r., o oznaczeniu WR1F/GR/16/2023/39, w zakresie rozstrzygnięcia w przedmiocie otwarcia postępowania restrukturyzacyjnego jest prawomocne z dniem 25 lipca 2023 r.",
"url": "https://www.imsig.pl/lista-upadlosci/ogloszenia/651d667e2323c65e8e17e295"
}
}
Limits
Jede API-Anfrage an den Endpunkt „/v2/announcements“ verringert das monatliche Kontingent an Anfragen, das Ihrem Abonnement zugewiesen ist.
Das System unterscheidet zwei grundlegende Obergrenzen für die API, je nach Veröffentlichungsdatum der Ausschreibungen:
1️⃣ Aktuelle Anzeigen – veröffentlicht vor dem ersten Tag des Monats, in dem dein Dienst aktiviert wird.
2️⃣ Archivierte Anzeigen – umfassen Daten vor dem ersten Tag des Monats, in dem der Dienst aktiviert wurde. Das Abrufen dieser Daten verbraucht ein separates Abfragekontingent für archivierte Anzeigen. Die Höhe dieses Kontingents hängt von deinem Abonnement ab.
Das Limit wird bei jedem Aufruf der Funktion verringert, unabhängig von der Anzahl der in der Antwort zurückgegebenen Einträge und davon, ob sich die Abfrage auf ein einzelnes Unternehmen oder den gesamten Zeitraum bezog.
Auch die Erstellung einer Abfrage, die keine Ergebnisse liefert (leere Liste), verringert das verfügbare Limit.
Suchen im Bereich „Insolvenzverzeichnis“ und automatisch über die API durchgeführte Abfragen nutzen denselben Pool verfügbarer Abfragen.
Wir empfehlen, die Limits regelmäßig zu überprüfen, insbesondere während der Integrationsphase, bei der ersten Inbetriebnahme automatisierter Prozesse und bei der Verarbeitung großer Mengen von Identifikatoren.
Überschreitung des Limits
Sobald das Kontingent an Anfragen aufgebraucht ist, gibt die API den Antwortcode„429 – Too Many Requests“ zurück.
Dieser Code bedeutet, dass das monatliche Limit ausgeschöpft ist und weitere Anfragen erst dann bearbeitet werden, wenn es im neuen Abrechnungszeitraum erneuert oder das Abonnement (jederzeit) erhöht wird.
Es handelt sich hierbei um eine absichtliche Sperre, die sich aus den Abrechnungsregeln für den Dienst ergibt, und sie sollte als Signal verstanden werden, weitere Anfragen zu unterlassen.
👉 Erfahren Sie mehr über die Limits: Wie kann man die Ausschöpfung der Limits in der Insolvenzliste überprüfen?
👉 Hier finden Sie das aktuelle Angebot und die Preisliste: Insolvenzverzeichnis – Preisliste
