Poland KRZ National Debtor Registry Scraper | Krajowy Rejestr Zadłużonych

EN: Search the Krajowy Rejestr Zadłużonych (KRZ) — Poland's National Debtor Registry — for bankruptcy, restructuring, and enforcement proceedings. No public API exists. This is the only programmatic access to KRZ data outside of commercial providers like MGBI.

PL: Automatyczne przeszukiwanie Krajowego Rejestru Zadłużonych (KRZ) — sprawdzenie dłużnika pod kątem upadłości, restrukturyzacji i postępowań egzekucyjnych. Ministerstwo nie udostępnia publicznego API. Jedyny programistyczny dostęp do danych KRZ poza płatnymi subskrypcjami MGBI/iMSiG.

Why This Actor Exists | Dlaczego ten aktor?

EN: KRZ has been online since December 2021, but the Ministry of Justice has never released a public API despite years of promises. The only alternatives are:

• Manual web searches at krz.ms.gov.pl (slow, no bulk access)
• MGBI/iMSiG commercial API (paid subscription)
• This actor — free, automated, structured JSON output

PL: KRZ działa od grudnia 2021, ale Ministerstwo Sprawiedliwości wciąż nie udostępniło publicznego API. Jedyne alternatywy to:

• Ręczne wyszukiwanie na krz.ms.gov.pl (wolne, brak eksportu masowego)
• MGBI/iMSiG — komercyjne API (płatna subskrypcja, €200-500/mies.)
• Ten aktor — automatyczny dostęp, pay-per-use, JSON

How It Works

1. Puppeteer loads the KRZ portal and triggers the Angular sub-app
2. The sub-app issues a JWT token during initialization
3. The actor captures the JWT and uses it to call internal REST endpoints directly
4. Results are returned as structured JSON — no DOM scraping, no fragile selectors

Search Modes

Proceedings & Entities (core KRZ data)

Mode	Searches For	Required Input
entity	Companies/organizations with proceedings	entityName and/or identifier (KRS/NIP/REGON)
person	Natural persons with proceedings	identifier (PESEL or NIP)
soleTrader	Sole traders (JDG) with proceedings	entityName and/or identifier
signature	Proceedings by court case signature	caseSignature (e.g., WA1M/GU/223/2021)
proceedingDetails	Full details of a specific proceeding	proceedingId (UUID from a prior search)

Announcements (Tablica Obwieszczeń)

Mode	Searches For	Required Input
announcements	Court announcements and notices	entityName/identifier + dateFrom/dateTo, or caseSignature

Supporting Registries

Mode	Searches For	Required Input
shareholders	Partners in personal companies (spółki osobowe)	identifier (KRS/NIP) or entityName
bankruptcyEstate	Assets for sale from bankruptcy estates	entityName and/or identifier, optional estateType
advisors	Licensed restructuring advisors	entityName (surname), identifier (license #), or advisorCity

Input

Parameter	Type	Required	Default	Description
searchMode	string	No	entity	Search type (see tables above)
entityName	string	No	—	Company name, business name, or advisor surname
identifier	string	No	—	KRS, NIP, REGON, PESEL, or license number
caseSignature	string	No	—	Case signature (CODE/REPERTORY/NUMBER/YEAR)
proceedingId	string	No	—	Proceeding UUID (from prior search result)
estateType	string	No	—	Asset type filter for bankruptcyEstate mode
advisorCity	string	No	—	City filter for advisors mode
dateFrom	string	No	—	Date range start (YYYY-MM-DD), for announcements
dateTo	string	No	—	Date range end (YYYY-MM-DD), for announcements
maxResults	integer	No	100	Max results (0 = unlimited)
proxyConfiguration	object	No	—	Apify Proxy config (residential PL recommended)

Input Examples

Search for a bankrupt company:

{
  "searchMode": "entity",
  "entityName": "Getin"
}

Check if a company has proceedings by KRS:

{
  "searchMode": "entity",
  "identifier": "0000585174"
}

Get announcements for a company:

{
  "searchMode": "announcements",
  "entityName": "Getin Noble Bank",
  "dateFrom": "2024-01-01",
  "dateTo": "2026-03-31"
}

Search by case signature:

{
  "searchMode": "signature",
  "caseSignature": "WA1M/GUp/44/2023"
}

Output (Entity/Person Search)

{
  "entityName": "GETIN RENT SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ",
  "nip": "8992777278",
  "krs": "0000585174",
  "regon": null,
  "proceedingId": "96dd6ffc-191c-41ce-bcc4-998524e4efd2",
  "caseSignature": null,
  "proceedingType": null,
  "proceedingStatus": null,
  "court": null,
  "role": null,
  "searchType": "entity",
  "sourceUrl": "https://krz.ms.gov.pl/"
}

Output (Announcements)

{
  "id": "fc825e9b-d048-466f-a2b4-c963944a2fc2",
  "announcementNumber": "20240916/00375",
  "entityName": "Getin Noble Bank S.A.",
  "caseSignature": "WA1M/GUp/44/2023",
  "category": "Masa upadłości",
  "publicationDate": "2024-09-16",
  "content": null,
  "court": "Sąd Rejonowy dla m.st.Warszawy w Warszawie",
  "sourceUrl": "https://krz.ms.gov.pl/"
}

Use Cases | Zastosowania

• Credit Risk / Ryzyko kredytowe — check if customers, suppliers, or partners have bankruptcy/restructuring proceedings | weryfikacja wypłacalności kontrahentów
• Debt Collection / Windykacja — verify debtor status before pursuing claims | sprawdzenie dłużnika przed wszczęciem postępowania
• KYC/AML / Compliance — screen entities against the debtor registry | weryfikacja podmiotów w rejestrze dłużników
• Due Diligence / Badanie firmy — check target companies for insolvency proceedings | sprawdzenie upadłości i restrukturyzacji
• Legal Research / Kancelarie prawne — find court announcements and case details | wyszukiwanie obwieszczeń i sygnatur spraw
• Bulk Screening / Masowa weryfikacja — batch checks against KRZ for entire portfolios | sprawdzenie setek firm jednocześnie

Data Source

• Portal: https://krz.ms.gov.pl/
• Operator: Ministry of Justice (Ministerstwo Sprawiedliwości)
• Legal basis: Ustawa z dnia 6 grudnia 2018 r. o Krajowym Rejestrze Zadłużonych
• Data since: December 1, 2021
• Coverage: All bankruptcy, restructuring, and enforcement proceedings in Poland

Technical Notes

• Session establishment takes ~10-15 seconds (Puppeteer loads the SPA)
• After session, API calls are fast (~200ms each)
• JWT tokens expire after ~30 minutes
• The actor processes all results within a single session
• PESEL numbers are NOT collected for privacy compliance

KRZ API Alternative — No Subscription Required

There is no public API for the Krajowy Rejestr Zadluzonych. The Ministry of Justice has not released one despite years of promises. This Actor gives you programmatic access to KRZ data on a pay-per-use basis — no subscription, no commitment, no contract. Just call the Apify API and get structured JSON back.

Unlike MGBI or iMSiG, you only pay for what you use. Run a single check or screen an entire portfolio — pricing scales with your actual usage.

Polish Bankruptcy Data for KYC/AML Compliance

KRZ is a critical data source for Know Your Customer (KYC) and Anti-Money Laundering (AML) workflows in Poland. Every company and individual with bankruptcy, restructuring, or enforcement proceedings since December 2021 is listed here. Automate your compliance checks by integrating this Actor into your screening pipeline via the Apify API.

Credit Risk Monitoring — Automatic Debtor Checks

Set up scheduled runs to monitor your customer or supplier portfolio against the Polish National Debtor Registry. Detect bankruptcy and restructuring proceedings early — before they impact your business. Combine with MSiG court gazette data for comprehensive credit risk coverage.

MGBI Alternative — Pay Per Use, No Commitment

MGBI and iMSiG offer KRZ API access through paid subscriptions. This Actor provides the same data — structured JSON from the Krajowy Rejestr Zadluzonych — without a subscription. Pay only for the Apify compute you use. Ideal for teams that need occasional checks, proof-of-concept integrations, or want to avoid vendor lock-in.

Informacje po polsku

Czym jest ten aktor?

Ten aktor umożliwia automatyczne sprawdzenie dłużnika w Krajowym Rejestrze Zadłużonych (KRZ) — oficjalnym rejestrze dłużników prowadzonym przez Ministerstwo Sprawiedliwości. KRZ nie udostępnia publicznego API, a jedyną alternatywą do tej pory były ręczne wyszukiwania na portalu krz.ms.gov.pl lub płatne subskrypcje u dostawców takich jak MGBI czy iMSiG. Ten aktor stanowi alternatywę dla MGBI — płacisz wyłącznie za faktyczne użycie, bez abonamentu i bez umowy.

Dla kogo?

Narzędzie jest przeznaczone przede wszystkim dla firm windykacyjnych przeprowadzających weryfikację kontrahenta przed wszczęciem postępowania egzekucyjnego, działów ryzyka kredytowego monitorujących wypłacalność klientów i dostawców, kancelarii prawnych obsługujących sprawy z zakresu upadłości i restrukturyzacji, oraz działów compliance realizujących procedury KYC/AML. Z narzędzia korzystają również analitycy ryzyka kredytowego, specjaliści ds. compliance, kancelarie windykacyjne, prawnicy oraz analitycy KYC/AML.

Co można sprawdzić?

Aktor obsługuje pełne przeszukiwanie KRZ: wyszukiwanie podmiotów i osób fizycznych z postępowaniami upadłościowymi lub restrukturyzacyjnymi, przeglądanie tablicy obwieszczeń, sprawdzanie masy upadłości, wyszukiwanie doradców restrukturyzacyjnych oraz wspólników spółek osobowych. Wystarczy podać nazwę firmy, NIP, KRS, REGON lub sygnaturę sprawy — wyniki zwracane są jako ustrukturyzowany JSON.

Jak zacząć?

Uruchom aktora na platformie Apify, podając dane podmiotu do weryfikacji. Możesz też zintegrować go ze swoim systemem przez Apify API i uruchamiać automatyczne sprawdzenia dłużników dla całego portfela. W porównaniu z MGBI i Transparent Data — brak subskrypcji, brak minimalnych opłat, rozliczenie wyłącznie za zużyte zasoby obliczeniowe.

Polish Business Data Suite

This Actor is part of a 5-actor Polish business intelligence suite on Apify. Together, these actors provide comprehensive company data for due diligence, compliance, credit risk, and B2B prospecting in Poland.

Complete Polish Company Intelligence Workflow:
1. Is the company solvent? → KRZ Debtor Registry
2. Any court proceedings? → MSiG Court Gazette
3. What are their financials? → eKRS Financial Statements
4. Who runs the company? → KRS Board Members
5. Are they properly licensed? → KNF Financial Registry

All actors in the suite:

• Poland KRZ Debtor Registry Scraper — bankruptcy, restructuring, and enforcement proceedings
• Poland MSiG Court Gazette Scraper — official court and economic gazette announcements
• Poland KRS Financial Statements Scraper — balance sheets and income statements from eKRS
• Poland KRS Board Members Scraper — non-anonymized board member and shareholder names
• Poland KNF Financial Registry Scraper — KNF-supervised financial entities

Limitations

• Session must be re-established for each actor run (JWT expiration)
• Results are limited to 250 per search query (KRZ server limit)
• Processing time: ~15s for session + ~1s per query
• Some entity types may have different response structures

Pricing Rationale

This actor competes with MGBI's paid KRZ API (subscription pricing). The only free alternative is manual web lookups. As the sole Apify actor providing KRZ access, pricing should reflect the high value and zero competition.

Related Actors

• Poland MSiG Court Gazette Scraper — official court and economic gazette announcements
• Poland KRS Financial Statements Scraper — balance sheets and income statements from eKRS
• Poland KRS Board Members Scraper — non-anonymized board member and shareholder names
• Poland KNF Financial Registry Scraper — KNF-supervised financial entities