Poland KRZ National Debtor Registry Scraper

Search Polish National Debtor Registry (KRZ) and National Court Register (KRS) bankruptcy, restructuring, liquidation, and enforcement proceeding records by KRS or NIP, and export structured dataset records.

No API key is required. The Actor performs direct scraping of the official Polish Ministry of Justice Open Register (api-krs.ms.gov.pl) and Ministry of Finance White List Register (wl-api.mf.gov.pl). If you have a licensed MGBI API key, you can optionally supply it to route queries through MGBI.

Data sources and access

1. Official Ministry of Justice KRS Register (api-krs.ms.gov.pl - Default / Free):
   • Direct, open public government endpoint.
   • Accesses Dział 6 (bankruptcy proceedings postepowanieUpadlosciowe, restructuring proceedings postepowanieRestrukturyzacyjne, liquidation likwidacja, dissolution rozwiazanieUniewaznienie, compulsory management zarzadKomisarycznyPrzymusowy).
   • Accesses Dział 4 (official tax, customs, and social insurance ZUS arrears, enforcement proceedings informacjaOEgzekucji, discontinued enforcements due to lack of assets, and creditor claims).
2. Ministry of Finance White List Register (wl-api.mf.gov.pl - Default / Free):
   • Automatically resolves 10-digit Polish NIP tax identifiers to their official KRS number, registered legal name, REGON, and address.
3. MGBI Public Registers API (Optional):
   • Supply apiKey only if you want to use your licensed MGBI account.

What each result contains

One dataset item represents one validated proceeding record. It includes:

Field	Meaning	Example
searchReference	Label supplied for the lookup	sample-debtor-pbg
debtorName	Official registered entity name	PBG SPÓŁKA AKCYJNA W RESTRUKTURYZACJI W LIKWIDACJI
krs	10-digit KRS number	0000184508
nip	10-digit NIP tax ID	7772194746
proceedingId	Registry proceeding ID or signature	XI GU 149/12
caseSignature	Court case signature	XI GU 149/12
proceedingType	Proceeding category	Postępowanie upadłościowe
proceedingStatus	Current legal proceeding status	Zakończone (XI GUP 29/12)
startedAt	Opening / declaration date	2012-06-13
createdAt	Entity KRS registration date	2004-01-02
endedAt	Conclusion / completion date	2016-07-20
source	Source registry	KRS Rejestr Dłużników i Postępowań (api-krs.ms.gov.pl)
sourceUrl	Official registry portal	https://krz.ms.gov.pl/
retrievedAt	UTC timestamp of extraction	2026-10-06T10:00:00.000Z

Privacy guarantee: PESEL numbers are never written to dataset records, OUTPUT, terminal status messages, or logs. Reference labels containing 10-digit-or-longer numbers are rejected to prevent identifier leakage.

Input

Provide one or more identifier searches (krs or nip). The default prefill checks PBG S.A. (0000184508), a public entity with documented bankruptcy and restructuring proceedings.

{
  "searches": [
    { "identifierType": "krs", "identifier": "0000184508", "reference": "sample-debtor-pbg" }
  ],
  "maxSearches": 1,
  "maxResults": 100
}

Or query by Polish NIP tax ID:

{
  "searches": [
    { "identifierType": "nip", "identifier": "7772194746", "reference": "debtor-by-nip" }
  ],
  "maxSearches": 1,
  "maxResults": 100
}

Optional settings:

• apiKey: Supply your licensed MGBI key only if routing through MGBI. Leave blank for direct public scraping.
• maxSearches: Maximum number of identifiers to process (1 to 20).
• maxResults: Hard cap on proceeding records written to the dataset across all searches (1 to 1,000). Free Apify plan runs are capped at 5 records.

Run summary and outcomes

The Actor writes diagnostics to the default key-value store as OUTPUT. Outcomes:

• DATA: One or more proceedings delivered.
• EMPTY: Valid entity found in registry, but has no bankruptcy, restructuring, or debtor proceedings registered (e.g. solvent companies).
• PARTIAL: One or more lookups had warnings (e.g. entity not found in registry or sole proprietorship without commercial court entries).
• REJECTED: Invalid input syntax or missing required fields.
• FAILED: Systemic network failure.

Billing (Pay per event)

Monetized with Pay-per-event (PPE). Platform usage is covered (isPPEPlatformUsagePaidByUser = false).

Event	FREE	BRONZE	SILVER	GOLD	When charged
Actor start (apify-actor-start)	$0.005	$0.005	$0.005	$0.005	Once when a run starts
KRZ proceeding record (apify-default-dataset-item)	$0.010	$0.00975	$0.00950	$0.00800	Per validated proceeding saved to dataset

Local development

npm test
npm run validate:input
npm run preflight
apify run