Якщо ви керуєте великим портфелем суб’єктів господарювання і з міркувань безпеки або відповідно до внутрішніх правил не бажаєте передавати їхні ідентифікаційні номери назовні, оптимальним рішенням є так зване«пакетне завантаження».
Замість того, щоб запитувати про кожного клієнта окремо, ви завантажуєте повний набір нових оголошень, опублікованих у KRZ та MSIG за обраний період.
- Можливість пошуку та завантаження всіх актуальних оголошень без введення даних боржника (наприклад, ІПН, PESEL) доступна виключно в тарифних планах «Pro» та «Enterprise» сервісу «Списки банкрутств».
- У тарифних планах «Міні» та «Стандарт» завжди потрібно вказати конкретний ідентифікатор.
У цьому посібнику ви дізнаєтеся, як завантажити повний перелік оголошень про банкрутство та реструктуризацію за обраний період без введення ідентифікаційних кодів суб’єктів, що вас цікавлять.
Що таке API списку банкрутств?
API (Application Programming Interface) — це інтерфейс прикладного програмування, тобто набір правил і протоколів, що забезпечують безпосередню взаємодію між різними інформаційними системами.
Він працює як«цифровий міст», що дозволяє вашому програмному забезпеченню (наприклад, CRM або ERP) автоматично використовувати функції та ресурси Реєстру банкрутств без втручання людини.
На практиці ваша система «підключається» до віртуального вікна адміністрації, проходить аутентифікацію за допомогою унікального ключа та одразу отримує замовлений комплект документів у машиночитаному форматі.
Ключ авторизації
Кожен запит до API має бути автентифікований. Для цього використовується унікальний ключ API (ключ авторизації / токен), який ідентифікує вашу підписку та контролює доступні ліміти запитів.
Щоб отримати ключ API, увійдіть на сайт iMSiG.pl, перейдіть у вкладку «Список банкрутств», а потім відкрийте «Параметри послуги».
У нижній частині сторінки, у розділі«API», ти знайдеш свій ключ авторизації та посилання на повну документацію («Версія API»).
Пам’ятайте, що ключ API є спільним для всіх користувачів в рамках одного абонемента, а це означає, що головний обліковий запис і всі субоблікові записи працюють з одним і тим самим ключем.
Крок 1: Перевірка списку оновлень
Щоб завантажити дані за обраний період, спочатку потрібно визначити ідентифікатори оновлень, які були внесені до наших баз даних у цей період.
Параметри запиту:
- Початок часового діапазону: creation_datetime_from
- Кінець часового діапазону: creation_datetime_to
Частота живлення бази:
- Національний реєстр боржників (KRZ): дані оновлюються щогодини у робочі дні (з 7:00 до 21:00).
- «Судовий та економічний монітор» (MSiG): оновлення відбувається раз на день, зазвичай близько 11-ї години.
Національний реєстр боржників іноді оновлюється до пізнього вечора, тому ми рекомендуємо завантажувати дані за попередній день лише наступного ранку.
Найефективнішим методом є запуск циклічного інструменту, який щоранку запитує API про оновлення за останні 24 години.
Приклад запиту
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: [ключ авторизації]
У відповіді ви отримаєте перелік усіх оновлень, які були внесені до нашого сервісу за вказаний період, із унікальними ідентифікаторами оновлень (id) та кількістю оголошень у кожному з них (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"
},
...
]
Крок 2: Завантаження вмісту оголошень
Коли API поверне список оновлень:
- Визнач, для яких із них ти ще не завантажив оголошення.
- Запишіть їхні ідентифікатори: id (наприклад, 8002).
- Для кожного ідентифікатора оновлення викличте головний ендпоінт з оголошеннями GET /v2/announcements, передавши його в параметрі update_id.
Приклад запиту
GET /v2/announcements?update_id=8002 HTTP/1.1
Host: api.imsig.pl
Authorization: [ключ авторизації]
Цей запит поверне повний набір оголошень (у форматі JSON), що містяться в цьому конкретному оновленні.
[
{
"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"
}
},
...
]
Після завантаження оголошень варто порівняти їхню кількість із значенням параметра«announcements_count» з першого кроку, щоб переконатися, що ваша система правильно отримала всі дані з обраного оновлення.
Структура даних
Дані повертаються у форматі JSON, що дозволяє безпосередньо імпортувати їх у внутрішні системи (наприклад, CRM або ERP).
Основні розділи відповіді
У відповіді API можна виділити такі групи даних:
- id — унікальний ідентифікатор оголошення в базі даних MGBI
- метадані — технічна інформація про запис, зокрема дата публікації (issue_date), а також дати першого та останнього оновлення оголошення в системі.
- суб’єкт — детальні дані про суб’єкта (або суб’єктів), якого стосується справа: назва, організаційно-правова форма, код PKD та адреса місцезнаходження.
- провадження — деталі судового провадження: назва суду, реєстраційні номери справи та дані ліквідатора або наглядача (назва або ім’я та прізвище, посада).
- ухвала— дані щодо конкретного рішення суду, наприклад, його дата.
- krz_entry / msig_entry — детальні параметри публікації залежно від джерела (розділ, підрозділ, посилання на оригінальне оголошення на урядовому порталі).
- content — повний текст оголошення, доступний у двох форматах: текстовому (text) та HTML (зі збереженням структури оригіналу).
Повний перелік та опис полів можна знайти в документації API, у розділі «GET /v2/announcements»: Перегляньте документацію
Коди відповідей HTTP
Найпоширеніші коди відповідей, які має підтримувати ваша система:
- 200 (Успіх): запит виконано правильно.
- 401 / 403 (Помилка авторизації): неправильний або відсутній ключ API.
- 429 (Перевищення ліміту): ви вичерпали весь ліміт запитів на цей місяць.
Якщо ви отримаєте код помилки 429 (Too Many Requests), це означає, що місячний ліміт запитів вичерпано.
Ліміти
Кожен запит API, надісланий на ендпоінт "/v2/announcements",зменшує місячний ліміт запитів, виділенийдля вашого абонемента.
Система розрізняє два основні ліміти для API залежно від дати публікації оголошень:
1️⃣ Актуальні оголошення — опубліковані до першого дня місяця, в якому активується ваша послуга.
2️⃣ Архівні оголошення — містять дані за період до першого дня місяця, в якому було активовано послугу. Завантаження цих даних витрачає окремий ліміт запитів для архівних оголошень. Його розмір залежить від вашого тарифного плану.
Ліміт зменшується при кожному виклику функції, незалежно від кількості оголошень, повернуті у відповіді, та від того, чи запит стосувався одного суб’єкта, чи всього періоду.
Створення запиту, який не поверне жодних результатів (порожній список), також зменшує доступний ліміт.
Запити, що виконуються вручну в панелі «Списки банкрутств», та запити, що виконуються автоматично через API, використовують один і той самий пул доступних запитів.
Рекомендуємо регулярно перевіряти стан лімітів, особливо на етапі інтеграційних тестів, під час першого запуску автоматизованих процесів та у разі роботи з великою кількістю ідентифікаторів.
Перевищення ліміту
Після вичерпання доступного ліміту запитів API поверне код відповіді: «429 – Too Many Requests».
Цей код означає, що місячний ліміт вичерпано, і подальші запити не будуть оброблятися до моменту його поновлення в новому розрахунковому періоді або підвищення абонентської плати (у будь-який час).
Це свідоме блокування, зумовлене правилами розрахунків за послугу, і його слід розглядати як сигнал про необхідність припинити подальші запити.
👉 Дізнайтеся більше про ліміти: Як перевірити використання лімітів у «Списку банкрутств»?
👉 Ознайомтеся з актуальною пропозицією та прайс-листом: «Список банкрутств» — прайс-лист
