Poland KRZ National Debtor Registry Scraper | Krajowy Rejestr Zadluzonych

Check whether any Polish company or person has bankruptcy, restructuring, or enforcement proceedings in the National Debtor Registry (KRZ) - structured JSON, in bulk, beyond what the register's manual web search allows. Search by company name, NIP, KRS, REGON, PESEL, or case signature across nine search modes, from the official Ministry of Justice register that has no public API.

No login, no API key, nothing to configure - paste a name or tax ID and get a debtor-status record back. It is the pay-per-use alternative to commercial providers like MGBI or iMSiG (typically $200-500/month).

What data do you get?

One record per match, linking the entity to its proceeding:

{
  "entityName": "GETIN RENT SPOLKA Z OGRANICZONA ODPOWIEDZIALNOSCIA",
  "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/"
}

An entity/person search tells you whether a proceeding exists and returns its proceedingId. To pull the full case detail (type, status, court, role), pass that id back in with searchMode: "proceedingDetails".

Field	Description
entityName	Company or person name
nip / krs / regon	Polish tax, court-registry, and statistical IDs
proceedingId	UUID for fetching full proceeding details
caseSignature	Court case signature
proceedingType	Bankruptcy, restructuring, enforcement, etc.
proceedingStatus	Current status of the proceeding
court	Court handling the case
role	The entity's role in the proceeding
searchType	The search mode used
sourceUrl	Source register URL

How much does the KRZ data cost?

Pay per use - you are not charged for Apify platform usage, only a flat fee per search plus a small fee per result returned.

Event	Cost
Per search	$0.025
Per result	$0.006

A search returning 6 results costs about $0.06. Most monitoring searches return few or no results, so cost is dominated by the flat per-search fee. The per-result price drops on higher Apify subscription tiers ($0.005 / $0.004 / $0.003 on Bronze / Silver / Gold). Apify's $5 monthly free credit covers roughly 200 searches. No subscription, no minimum.

Is it legal, and where does the data come from?

Data comes from the official KRZ portal at krz.ms.gov.pl, operated by Poland's Ministry of Justice under the Act on the National Debtor Registry (Ustawa z dnia 6 grudnia 2018 r. o Krajowym Rejestrze Zadluzonych). The register is public and covers all bankruptcy, restructuring, and enforcement proceedings in Poland since 1 December 2021. Extraction of this public data is permitted; you remain responsible for lawful, GDPR-compliant use of any personal data downstream. For privacy, the actor does not collect PESEL numbers into the dataset.

How do I use it?

Click Try it and paste this input:

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

Or screen by identifier ({ "searchMode": "entity", "identifier": "8992777278" }). To check a whole portfolio, run one search per counterparty (or automate via the API).

Input options

Parameter	Type	Required	Default	Description
searchMode	string	No	entity	Search type (see modes below)
entityName	string	No	-	Company name, business name, or advisor surname
identifier	string	No	-	KRS, NIP, REGON, PESEL, or licence number
caseSignature	string	No	-	Case signature (CODE/REPERTORY/NUMBER/YEAR)
proceedingId	string	No	-	Proceeding UUID (from a prior search result)
estateType	string	No	-	Asset-type filter for bankruptcyEstate mode
advisorCity	string	No	-	City filter for advisors mode
dateFrom / dateTo	string	No	-	Date range (YYYY-MM-DD), for announcements
maxResults	integer	No	100	Max results (0 = unlimited)

Nine search modes

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
proceedingDetails	Full details of one proceeding	proceedingId (UUID from a prior search)
announcements	Court announcements and notices	entityName/identifier + dateFrom/dateTo, or caseSignature
shareholders	Partners in personal companies	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 (licence #), or advisorCity

What you can do with it

• Credit-risk checks - before extending a facility or terms, confirm a customer, supplier, or partner has no bankruptcy or restructuring proceeding.
• Debt collection - verify a debtor's proceeding status before pursuing a claim, and pull the case signature and court for your file.
• KYC / AML screening - screen counterparties against the debtor register as part of onboarding.
• M&A due diligence - check an acquisition target and its shareholders for insolvency proceedings.
• Ongoing monitoring - schedule a recurring batch over your portfolio and catch new filings early.
• Distressed-asset sourcing - use bankruptcyEstate mode to find assets for sale from bankruptcy estates.

Run it from code

# cURL - start a run and get the dataset back
curl -X POST "https://api.apify.com/v2/acts/regdata~krz-debtor-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "searchMode": "entity", "entityName": "Getin" }'

// Node.js - apify-client
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('regdata/krz-debtor-scraper').call({ searchMode: 'entity', entityName: 'Getin' });
const { items } = await client.dataset(run.defaultDatasetId).listItems();

# Python - apify-client
from apify_client import ApifyClient
client = ApifyClient("YOUR_TOKEN")
run = client.actor("regdata/krz-debtor-scraper").call(run_input={"searchMode": "entity", "entityName": "Getin"})
items = client.dataset(run["defaultDatasetId"]).list_items().items

Integrations

Runs anywhere Apify does: call it from the REST API, schedule recurring debtor checks, pipe results into n8n / Make / Zapier, or use it from any MCP client (Claude, Cursor) via mcp.apify.com.

FAQ

Is it legal to scrape KRZ? Yes. KRZ is an official, public register published by Poland's Ministry of Justice for exactly this kind of debtor verification. Extraction of public data is permitted; you remain responsible for lawful, GDPR-compliant use of any personal data downstream.

Do I need a KRZ account or an API key? No. No login, no key, nothing to configure - the register is public and the actor handles retrieval. You only need an Apify account to run it.

What does an empty result mean? That the entity has no proceeding in KRZ - a clean, meaningful answer for a credit or KYC check, not a failure. You are still charged the per-search fee (the search ran) but nothing per result.

How is this different from MGBI or iMSiG? Same underlying register, but pay-per-use instead of a $200-500/month subscription, and returned as structured JSON you can pipe straight into your systems.

What export formats are supported? JSON, CSV, Excel, or XML, or read live via the API.

How do I get the full detail of a proceeding? An entity or person search returns each match with a proceedingId. Pass that id back with searchMode: "proceedingDetails" to get the type, status, court, and role.

Limitations

• A single search returns up to 250 results (the register's own per-query cap). Narrow the query or use identifiers for exact matches.
• Coverage starts 1 December 2021 (the register's own start date).
• Some proceeding types return slightly different field structures.

Related actors

Part of a suite of official government registry actors - no public API, pay per result, no keys to supply.

Country	Actors
Poland	REGON/GUS · KRS financials · KRS board · CRBR UBO · KRZ debtors (this actor) · MSiG gazette · KNF · PEP · EKW land · UOKiK · BDO waste · Premises
Germany	Handelsregister · Insolvency
Spain	Company directory · BORME acts · Concursal
Italy	Registro Imprese · PEC lookup
Austria	WKO directory · Ediktsdatei
France	Societe.com
Belgium	KBO/BCE
Czechia	ISIR insolvency
Slovakia	RPVS UBO
UAE	ADGM register
USA	California SoS · California UCC liens
Global	Adverse media

Common combination: company register -> UBO -> debtors (this actor) -> adverse media is the standard KYB/onboarding chain.

Full suite: apify.com/regdata · Callable from any MCP client via mcp.apify.com

Informacje po polsku

Czym jest ten aktor?

Ten aktor umozliwia automatyczne sprawdzenie dluznika w Krajowym Rejestrze Zadluzonych (KRZ) - oficjalnym rejestrze prowadzonym przez Ministerstwo Sprawiedliwosci. KRZ nie udostepnia publicznego API, a dotychczasowa alternatywa to reczne wyszukiwania na portalu krz.ms.gov.pl lub platne subskrypcje (MGBI, iMSiG). Ten aktor to alternatywa dla MGBI - placisz wylacznie za faktyczne uzycie, bez abonamentu.

Dla kogo?

Dla firm windykacyjnych weryfikujacych kontrahenta przed egzekucja, dzialow ryzyka kredytowego monitorujacych wyplacalnosc klientow i dostawcow, kancelarii prawnych obslugujacych upadlosci i restrukturyzacje oraz dzialow compliance realizujacych KYC/AML.

Co mozna sprawdzic?

Pelne przeszukiwanie KRZ: podmioty i osoby fizyczne z postepowaniami upadlosciowymi lub restrukturyzacyjnymi, tablica obwieszczen, masa upadlosci, doradcy restrukturyzacyjni oraz wspolnicy spolek osobowych. Wystarczy podac nazwe firmy, NIP, KRS, REGON lub sygnature sprawy - wyniki jako ustrukturyzowany JSON. Placisz tylko za wyszukiwania i wyniki; brak wynikow to nadal wazna odpowiedz.

---

Krajowy Rejestr Zadluzonych - wyszukiwanie dluznikow online

Przeszukiwanie Krajowego Rejestru Zadluzonych (KRZ) pod katem upadlosci, restrukturyzacji i postepowan egzekucyjnych. 9 trybow wyszukiwania. Programistyczny dostep do rzadowego rejestru bez publicznego API. Alternatywa dla MGBI bez abonamentu. Niezbedne narzedzie KYC/AML do weryfikacji kontrahentow.