Gov APIkrz.ms.gov.pl ↗
Access Poland's Krajowy Rejestr Zadłużonych: search announcements, entity proceedings, restructuring advisors, and bankruptcy estate assets via 5 endpoints.
What is the Gov API?
The KRZ API provides structured access to Poland's National Register of Debtors (Krajowy Rejestr Zadłużonych) across 5 endpoints covering announcements, entity proceedings, licensed restructuring advisors, and bankruptcy estate components. The search_announcements endpoint alone returns court-issued notices across restructuring, bankruptcy, and business prohibition categories, each carrying the case signature, court, entity name, and subcategory code for downstream filtering and monitoring.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/07fc2889-8893-41f6-b18f-3e9214a0b166/get_announcement_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the complete dictionary of announcement category groups and their subcategories. Each group (restructuring proceedings, bankruptcy proceedings, business prohibition) contains subcategory codes that can be used as filters in search_announcements. The response is a fixed reference list.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "Array of category groups, each containing code, title, order, and an array of subcategories with their codes"
},
"sample": {
"data": {
"categories": [
{
"code": "PR",
"order": 1,
"title": "Postępowanie restrukturyzacyjne",
"subcategories": [
{
"code": "R11",
"order": 0,
"title": "Dzień układowy"
},
{
"code": "R01",
"order": 1,
"title": "Wniosek restrukturyzacyjny złożony przez dłużnika"
}
]
},
{
"code": "PU",
"order": 2,
"title": "Postępowanie upadłościowe",
"subcategories": [
{
"code": "U01",
"order": 1,
"title": "Wniosek o ogłoszenie upadłości złożony przez dłużnika"
}
]
}
]
},
"status": "success"
}
}About the Gov API
Announcement Board and Categories
The get_announcement_categories endpoint returns the full taxonomy of KRZ announcement types — groups such as restructuring proceedings, bankruptcy proceedings, and business prohibition, each with subcategory codes (e.g. R11, U01). Pass those codes directly to search_announcements as a comma-separated subcategories parameter alongside a date_from / date_to date range (ISO YYYY-MM-DD). The response includes the matched announcement objects, the server-side display_limit, a limit_exceeded flag, and total_in_database so you know whether you need to narrow the window to retrieve all records.
Entity Proceedings and Advisor Search
search_entities accepts either a full or partial entity_name or an identifier (KRS number zero-padded to 10 digits, NIP, or other identifier) — at least one must be supplied. It returns an array of entity proceeding objects with the same display_limit / limit_exceeded / total_in_database envelope. search_advisors exposes the licensed restructuring advisor registry (2,000+ records) with filters for first_name, last_name, city, and license_number; pagination is controlled via page and page_size (1–100, default 10), and the response includes total_pages and total_elements.
Bankruptcy Estate Components
search_bankruptcy_estate searches asset descriptions from active bankruptcy proceedings — movable property, real estate, and receivables. The required name parameter matches against component names and descriptions (e.g. samochod to find vehicles). Results are paginated at 250 items per page, with page, total_pages, and an items array in each response. This endpoint is useful for due-diligence workflows that need to identify distressed assets tied to a specific proceeding.
The Gov API is a managed, monitored endpoint for krz.ms.gov.pl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when krz.ms.gov.pl changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official krz.ms.gov.pl API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor new bankruptcy or restructuring announcements for a specific company using search_announcements with subcategory filters and a rolling date range.
- Verify whether a Polish company (by KRS or NIP) has active insolvency proceedings using search_entities.
- Build a due-diligence feed that alerts when a counterparty appears in the KRZ register.
- Enumerate distressed real estate or vehicle assets available from bankruptcy estates via search_bankruptcy_estate.
- Locate and contact licensed restructuring advisors by city or name using search_advisors.
- Track the volume of new proceedings filed in a given week by checking total_in_database across date-windowed announcement queries.
- Cross-reference a KRS number from a company registry against KRZ entity proceedings for credit-risk screening.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.