Jeśli zarządzasz dużym portfelem podmiotów i ze względów bezpieczeństwa lub wewnętrznych regulacji nie chcesz przekazywać ich identyfikatorów na zewnątrz, optymalnym rozwiązaniem jest tzw. „batch downloading”.
Zamiast pytać o każdego klienta z osobna, pobierasz komplet nowych ogłoszeń opublikowanych w KRZ i MSIG w wybranym okresie.
- Możliwość przeszukiwania i pobierania wszystkich aktualnych ogłoszeń bez podawania danych dłużnika (np. NIP, PESEL) jest dostępna wyłącznie w planach Pro oraz Enterprise Listy upadłości.
- Plany Mini i Standard zawsze wymagają wskazania konkretnego identyfikatora.
W tym poradniku dowiesz się jak pobrać komplet ogłoszeń o upadłości i restrukturyzacji w wybranym okresie bez podawania identyfikatorów interesujących Cię podmiotów.
Czym jest API Listy upadłości?
API (Application Programming Interface) to interfejs programowania aplikacji, czyli zestaw reguł i protokołów umożliwiających różnym systemom informatycznym bezpośrednią komunikację między sobą.
Działa on jak "cyfrowy most", który pozwala Twojemu oprogramowaniu (np. CRM lub ERP) automatycznie korzystać z funkcji i zasobów Listy upadłości bez udziału człowieka.
W praktyce Twój system „podchodzi” do wirtualnego okienka urzędowego, uwierzytelnia się unikalnym kluczem i natychmiast otrzymuje zamówiony komplet dokumentów w formacie zrozumiałym dla maszyn.
Klucz autoryzacji
Każde zapytanie do API musi być uwierzytelnione. Służy do tego unikalny klucz API (klucz autoryzacji / token), który identyfikuje Twój abonament i kontroluje dostępne limity zapytań.
Aby pozyskać klucz API zaloguj się w serwisie iMSiG.pl, wejdź w zakładkę "Lista upadłości", a następnie otwórz "Parametry usługi".
Na dole strony, w segmencie „API” znajdziesz swój klucz autoryzacji oraz link do pełnej dokumentacji ("Wersja API").
Pamiętaj, że klucz API jest wspólny dla wszystkich użytkowników w ramach jednego abonamentu, co oznacza, że konto główne i wszystkie subkonta operują na tym samym kluczu.
Krok 1: Sprawdzenie listy aktualizacji
Aby pobrać dane z wybranego okresu, najpierw musisz ustalić identyfikatory aktualizacji, które zostały wprowadzone w naszych zbiorach w tym okresie.
Parametry zapytania:
- Początek zakresu czasu: creation_datetime_from
- Koniec zakresu czasu: creation_datetime_to
Częstotliwość zasilania bazy:
- Krajowy Rejestr Zadłużonych (KRZ): dane aktualizowane są co godzinę w dni robocze (7–21).
- Monitor Sądowy i Gospodarczy (MSiG): aktualizacja następuje raz dziennie, zazwyczaj około godziny 11.
Krajowy Rejestr Zadłużonych bywa aktualizowany do późnych godzin wieczornych, dlatego zalecamy pobieranie danych za dzień poprzedni dopiero następnego dnia rano.
Najskuteczniejszą metodą jest uruchomienie cyklicznego narzędzia, które rano odpytuje API o aktualizacje z ostatnich 24 godzin.
Przykładowe zapytanie
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: [klucz autoryzacji]
W odpowiedzi otrzymasz listę wszystkich aktualizacji, które zostały wprowadzone w naszej usłudze w danym zakresie czasu, z unikalnymi identyfikatorami aktualizacji (id) oraz liczbą ogłoszeń w każdej z nich (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"
},
...
]
Krok 2: Pobieranie treści ogłoszeń
Gdy API zwróci listę aktualizacji:
- Ustal, dla których z nich nie pobrałeś jeszcze ogłoszeń.
- Zapisz ich identyfikatory: id (np. 8002).
- Dla każdego identyfikatora aktualizacji wywołaj główny endpoint z ogłoszeniami GET /v2/announcements, przekazując go w parametrze update_id.
Przykładowe zapytanie
GET /v2/announcements?update_id=8002 HTTP/1.1
Host: api.imsig.pl
Authorization: [klucz autoryzacji]
To zapytanie zwróci komplet ogłoszeń (w formacie JSON) zawartych w tej konkretnej aktualizacji.
[
{
"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"
}
},
...
]
Po pobraniu ogłoszeń warto porównać ich liczbę z wartością parametru "announcements_count" z pierwszego kroku, aby upewnić się, że Twój system poprawnie odebrał wszystkie dane z wybranej aktualizacji.
Struktura danych
Dane zwracane są w formacie JSON, co umożliwia ich bezpośredni import do systemów wewnętrznych (np. CRM lub ERP).
Główne sekcje odpowiedzi
W odpowiedzi API można wyróżnić następujące grupy danych:
- id - unikalny identyfikator ogłoszenia w bazie MGBI
- meta- informacje techniczne o rekordzie, m.in. data publikacji (issue_date) oraz daty pierwszej i ostatniej aktualizacji ogłoszenia w systemie.
- entity - szczegółowe dane podmiotu (lub podmiotów), którego dotyczy sprawa: nazwa, forma prawna, kod PKD oraz adres siedziby.
- proceeding - szczegóły postępowania sądowego: nazwa sądu, sygnatury akt oraz dane syndyka lub nadzorcy (nazwa bądź imię i nazwisko, funkcja).
- order - dane dotyczące konkretnego postanowienia sądu, np. jego data.
- krz_entry / msig_entry - szczegółowe parametry publikacji w zależności od źródła (rozdział, sekcja, link do oryginalnego obwieszczenia w portalu rządowym).
- content - pełna treść ogłoszenia udostępniana w dwóch formatach: tekstowym (text) oraz html (z zachowaniem struktury oryginału).
Pełny wykaz i opis pól znajdziesz w dokumentacji API, w sekcji "GET /v2/announcements": Sprawdź dokumentację
Kody odpowiedzi HTTP
Najczęstsze kody odpowiedzi, które powinien obsłużyć Twój system:
- 200 (Sukces): zapytanie wykonane poprawnie.
- 401 / 403 (Błąd autoryzacji): niepoprawny lub brakujący klucz API.
- 429 (Przekroczenie limitu): wykorzystałeś całą pulę zapytań w danym miesiącu.
Jeśli otrzymasz kod błędu 429 (Too Many Requests), oznacza to, że miesięczny limit zapytań został wyczerpany.
Limity
Każde zapytanie API skierowane do endpointu "/v2/announcements" pomniejsza miesięczną pulę zapytań przypisaną do Twojego abonamentu.
System rozróżnia dwa podstawowe limity dla API, w zależności od daty publikacji ogłoszeń:
1️⃣ Ogłoszenia aktualne - opublikowane przed pierwszym dniem miesiąca aktywacji Twojej usługi.
2️⃣ Ogłoszenia archiwalne - obejmują dane sprzed pierwszego dnia miesiąca aktywacji usługi. Ich pobieranie zużywa osobny limit zapytań dla ogłoszeń archiwalnych. Jego wysokość zależy od Twojego planu abonamentowego.
Limit jest pomniejszany przy każdym wywołaniu funkcji, niezależnie od liczby ogłoszeń zwróconych w odpowiedzi oraz faktu, czy zapytanie dotyczyło jednego podmiotu, czy całego okresu.
Wygenerowanie zapytania, które nie zwróci żadnych wyników (pusta lista), również pomniejsza dostępny limit.
Zapytania wykonywane ręcznie w panelu Listy upadłości oraz zapytania wykonywane automatycznie przez API korzystają z tej samej puli dostępnych zapytań.
Rekomendujemy regularne kontrolowanie stanu limitów, szczególnie na etapie testów integracji, podczas pierwszego uruchomienia automatycznych procesów i w przypadku pracy na dużych ilościach identyfikatorów.
Przekroczenie limitu
Po wykorzystaniu dostępnej puli zapytań API zwróci kod odpowiedzi: "429 – Too Many Requests".
Kod ten oznacza, że miesięczny limit został wyczerpany i kolejne zapytania nie będą realizowane do momentu jego odnowienia w nowym okresie rozliczeniowym lub podniesienia abonamentu (w dowolnym momencie).
Jest to świadoma blokada wynikająca z zasad rozliczania usługi i powinna być traktowana jako sygnał do wstrzymania dalszych zapytań.
👉 Dowiedz się więcej o limitach: Jak sprawdzić wykorzystanie limitów w Liście upadłości?
👉 Sprawdź aktualną ofertę i cennik: Lista upadłości - cennik
