Wenn Sie ein großes Portfolio an Unternehmen verwalten und aus Sicherheitsgründen oder aufgrund interner Vorschriften deren Identifikationsdaten nicht nach außen weitergeben möchten, istdassogenannte„Batch-Downloading“die optimale Lösung.
Anstatt nach jedem Kunden einzeln zu fragen, laden Sie alle neuen Anzeigen herunter, die im ausgewählten Zeitraum in KRZ und MSIG veröffentlicht wurden.
- Die Möglichkeit, alle aktuellen Anzeigen zu durchsuchen und herunterzuladen, ohne die Daten des Schuldners (z. B. Steuernummer, Sozialversicherungsnummer) anzugeben, ist ausschließlich in den Tarifen „Pro“ und „Enterprise“ von „Lista upadłości“ verfügbar.
- Bei den Tarifen „Mini“ und „Standard“ muss immer eine bestimmte Kennung angegeben werden.
In dieser Anleitung erfahren Sie, wie Sie alle Insolvenz- und Sanierungsbekanntmachungen für einen bestimmten Zeitraum abrufen können, ohne die Identifikationsnummern der für Sie relevanten Unternehmen angeben zu müssen.
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 Insolvenzliste automatisch und ohne menschliches Zutun zu nutzen.
In der Praxis „wendet“ sich Ihr System an das virtuelle Behördenschalterfenster, authentifiziert sich mit einem eindeutigen Schlüssel und erhält sofort den angeforderten Dokumentensatz in einem maschinenlesbaren Format.
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 gilt, was bedeutet, dass das Hauptkonto und alle Unterkonten denselben Schlüssel verwenden.
Schritt 1: Überprüfen der Update-Liste
Um Daten aus dem ausgewählten Zeitraum abzurufen, musst du zunächst die Aktualisierungs-IDs ermitteln, die in diesem Zeitraum in unsere Datenbestände aufgenommen wurden.
Suchparameter:
- Beginn des Zeitraums: creation_datetime_from
- Ende des Zeitraums: creation_datetime_to
Netzfrequenz der Basisstation:
- Nationales Schuldnerregister (KRZ): Die Daten werden an Werktagen stündlich aktualisiert (7–21 Uhr).
- Monitor Sądowy i Gospodarczy (MSiG): Die Aktualisierung erfolgt einmal täglich, in der Regel gegen 11 Uhr.
Das nationale Schuldnerregister wird manchmal bis spät in den Abend hinein aktualisiert; daher empfehlen wir, die Daten des Vortages erst am nächsten Morgen abzurufen.
Die effektivste Methode besteht darin, ein periodisch ablaufendes Tool zu starten, das morgens die API nach Aktualisierungen der letzten 24 Stunden abfragt.
Beispielanfrage
GET /v2/updates?creation_datetime_from=2026-09-22T00:00:00Z&creation_datetime_to=2026-02-02T00:00:00Z HTTP/1.1
Host: api.imsig.pl
Authorization: [Autorisierungsschlüssel]
Als Antwort erhältst du eine Liste aller Aktualisierungen, die in unserem Dienst innerhalb des angegebenen Zeitraums vorgenommen wurden, mit den eindeutigen Aktualisierungs-IDs (id) und der Anzahl der Ankündigungen in jeder Aktualisierung (announcements_count).
[
{
"id": 8002,
"creation_datetime": "2026-02-02T22:17:13.915000+02:00",
"issue_date": "2026-09-22",
"announcements_count": 1,
"source": "krz"
},
{
"id": 8001,
"creation_datetime": "2026-02-02T20:17:25.733000+02:00",
"issue_date":"2026-09-22",
"announcements_count": 5,
"source": "krz"
},
{
"id": 8000,
"creation_datetime": "2026-02-02T18:17:25.001000+02:00",
"issue_date": "2026-09-22",
"announcements_count": 5,
"source": "krz"
},
{
"id": 7999,
"creation_datetime": "2026-02-02T17:17:24.751000+02:00",
"issue_date": "2026-09-22",
"announcements_count": 5,
"source": "krz"
},
...
]
Schritt 2: Anzeigeninhalte abrufen
Wenn die API eine Liste mit Aktualisierungen zurückgibt:
- Finde heraus, für welche davon du noch keine Anzeigen heruntergeladen hast.
- Notieren Sie sich ihre IDs: id (z. B. 8002).
- Rufe für jede Update-ID den Haupt-Endpunkt für Ankündigungen ( GET /v2/announcements) auf und übergebe die ID im Parameter „update_id“.
Beispielanfrage
GET /v2/announcements?update_id=8002 HTTP/1.1
Host: api.imsig.pl
Authorization: [Autorisierungsschlüssel]
Diese Abfrage liefert alle Anzeigen (im JSON-Format), die in diesem bestimmten Update enthalten sind.
[
{
"id": "650df6494634a8d43457cad8",
"meta": {
"issue_date": "2026-02-02",
"category": "K.0.8.48",
"first_update_date": "2026-02-02",
"last_update_date": "2026-02-02",
"is_administrator_data_consistent": true,
"is_correction": false,
"is_entity_data_consistent": true
},
"entity": [
{
"info": {
"cleaned_name": "Geo-Term Polska SA",
"legal_form": "spółki akcyjne",
"ownership_type": "własność mieszana w sektorze prywatnym z przewagą własności krajowych osób fizycznych",
"primary_business": "74.10.Z Działalność w zakresie specjalistycznego projektowania",
"commencement_date": "1995-06-20"
},
"numbers": {
"nip": "9540020399",
"regon": "272624250",
"krs": "0000426336"
},
"address": {
"state": "małopolskie",
"powiat": "oświęcimski",
"gmina": "Oświęcim","town": "Oświęcim",
"street": "ul. Chemików",
"house_number": "1",
"zip_code": "32-600"
}
}
],
"proceeding": {
"court_name": "Sąd Rejonowy dla Krakowa-Śródmieścia w Krakowie",
"court_department": "VIII Wydział Gospodarczy dla spraw upadłościowych i restrukturyzacyjnych",
"signatures": [
"KR1S/GRz-nu/49/2026",
"KR1S/GRz/71/2026"
],
"administrator_name": "Wojciech Zymek",
"administrator_function": "syndyk",
"administrator_licence_number": 104,
"administrator_address": "Doradca Restrukturyzacyjny Wojciech Zymek ul. Jesionowa 22",
"administrator_zip_code": "40-158",
"administrator_town": "Katowice",
"administrator_source_url": "https://krz-rdr-gui-krz-rdr-prod.apps.ocp.prod.ms.gov.pl/rdr-api/wyszukiwarka/doradcy/1003"
},
"order": {
"order_date": "2026-02-02"
},
"krz_entry": {
"chapter": 0,
"section": 8,
"subsection": 48,
"signature": "20260202/00445",
"issue_date": "2026-02-02",
"url": "https://krz.ms.gov.pl/#!/application/KRZPortalPUB/1.4/KrzRejPubGui.SzczegolyObwieszczenia?params=JTdCJTIyaWRaZXduZXRyem55JTIyJTNBJTIyZjI2NmQwNzItNWNlMC00OGNhLTg2MjItMjFkN2UzZGMzM2Q0JTIyJTdtE"
},
"content": {
"text": "Sąd Rejonowy dla Krakowa-Śródmieścia w Krakowie VIII Wydział Gospodarczy dla spraw upadłościowych i restrukturyzacyjnych ul. Przy Rondzie 7, 31-547 Kraków, obwieszcza, że postanowieniem z 22 września 2026 r. wydanym w sprawie po wpłynięciu wniosku o zatwierdzenie układu w postępowaniu o zatwierdzenie układu dłużnika, którym jest GEO-TERM POLSKA spółka akcyjna z siedzibą w Oświęcimiu (KRS 0000426336), sygnatura akt KR1S/GRz/71/2026, postanowił:\n\nna podstawie art. 165 ust. 1 w zw. z art. 223 ust. 1 ustawy z dnia 15 maja 2015 r. Prawo restrukturyzacyjne odmówić zatwierdzenia układu.\n\nNa niniejsze postanowienie przysługuje zażalenie do Sądu Okręgowego w Krakowie XII Wydział Gospodarczy Odwoławczy za pośrednictwem Sądu Rejonowego dla Krakowa-Śródmieścia w Krakowie VIII Wydział Gospodarczy dla spraw upadłościowych i restrukturyzacyjnych. Zażalenie należy wnieść w terminie dwóch tygodni od dnia niniejszego obwieszczenia. Zażalenie podlega opłacie w wysokości 200,00 zł. Sąd odrzuci zażalenie, jeżeli będzie ono spóźnione, nieopłacone lub dotknięte brakami, które nie zostaną usunięte mimo wezwania.",
"html": "Sąd Rejonowy dla Krakowa-Śródmieścia w Krakowie VIII Wydział Gospodarczy dla spraw upadłościowych i restrukturyzacyjnych ul. Przy Rondzie 7, 31-547 Kraków, obwieszcza, że postanowieniem z 2.02.2026 r. wydanym w sprawie po wpłynięciu wniosku o zatwierdzenie układu w postępowaniu o zatwierdzenie układu dłużnika, którym jest GEO-TERM POLSKA spółka akcyjna z siedzibą w Oświęcimiu (KRS 0000426336), sygnatura akt KR1S/GRz/71/2026, postanowił:na podstawie art. 165 ust. 1 w zw. z art. 223 ust. 1 ustawy z dnia 15 maja 2015 r. Prawo restrukturyzacyjne odmówić zatwierdzenia układu.Na niniejsze postanowienie przysługuje zażalenie do Sądu Okręgowego w Krakowie XII Wydział Gospodarczy Odwoławczy za pośrednictwem Sądu Rejonowego dla Krakowa-Śródmieścia w Krakowie VIII Wydział Gospodarczy dla spraw upadłościowych i restrukturyzacyjnych. Zażalenie należy wnieść w terminie dwóch tygodni od dnia niniejszego obwieszczenia. Zażalenie podlega opłacie w wysokości 200,00 zł. Sąd odrzuci zażalenie, jeżeli będzie ono spóźnione, nieopłacone lub dotknięte brakami, które nie zostaną usunięte mimo wezwania.",
"url": "https://www.imsig.pl/lista-upadlosci/ogloszenia/650df6494634a8d43457bad8"
}
},
...
]
Nachdem Sie die Ankündigungen abgerufen haben, sollten Sie deren Anzahl mit dem Wert des Parameters„announcements_count“ aus dem ersten Schritt vergleichen, um sicherzustellen, dass Ihr System alle Daten aus dem ausgewählten Update korrekt empfangen hat.
Datenstruktur
Die Daten werden im JSON-Format zurückgegeben, was einen direkten Import in interne Systeme (z. B. CRM oder ERP) ermöglicht.
Die wichtigsten Abschnitte der Antwort
In der API-Antwort lassen sich folgende Datengruppen unterscheiden:
- id – eindeutige Kennung der Anzeige in der MGBI-Datenbank
- Meta-Informationen zum Datensatz, u. a. das Veröffentlichungsdatum (issue_date) sowie das Datum der ersten und letzten Aktualisierung der Anzeige 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 (unter Beibehaltung der Originalstruktur).
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.
Wenn Sie den Fehlercode 429 (Too Many Requests) erhalten, bedeutet dies, dass das monatliche Limit für Anfragen ausgeschöpft ist.
Limits
Jede API-Anfrage an den Endpunkt „/v2/announcements“verringert das monatliche Kontingent an Anfragen, das Ihrem Abonnementzugewiesen 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.
Manuell im Bereich „Insolvenzlisten“ durchgeführte Abfragen und automatisch über die API durchgeführte Abfragen nutzen denselben Pool an verfügbaren 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?
👉 Sehen Sie sich das aktuelle Angebot und die Preisliste an: Insolvenzliste – Preisliste
