Poland KRS — post‑eKRS‑2024 reality / API guide
Poland completed the long migration of its National Court Register (Krajowy Rejestr Sądowy, KRS) to a fully digital workflow under the eKRS system, with filings and extracts now generated electronically rather than through regional court registries. For developers building due‑diligence pipelines or KYB automation, that shift matters: the authoritative company register is now queryable online and structured enough to integrate programmatically. The core dataset remains public, though the surrounding ecosystem (financial statements, beneficial owners, pledges) still lives in separate portals. This guide explains what is actually accessible from the Polish registry today, what remains restricted, and how to query it programmatically.
What the registry actually exposes
The Polish company register is maintained by the Ministry of Justice and covers commercial companies, foundations, associations and partnerships. In practice, the programmatic surface comes from two combined data sources: the KRS court register itself and the GUS statistical business register (REGON).
Through the OpenRegistry adapter the following programmatic endpoints are available:
search_companies
Returns company matches by name or identifier. Supports free‑text names (minimum three characters) and several numeric identifiers including KRS, REGON and NIP.
get_company_profile
Returns the full statutory record for a company. The payload includes the legal form, registered address, board members, supervisory board (if applicable), PKD activity codes, capital information, and filing references recorded in the court register.
list_filings
Returns filing references (“wzmianki”) recorded in the register. These include annual accounts, auditor reports, and resolutions. Each entry includes the filing date, category and period covered.
get_officers
Returns current board members, supervisory board members, and procurists. Officer names are partially masked where Polish privacy rules require redaction of personal identifiers.
get_shareholders
For limited‑liability structures such as sp. z o.o. and partnerships, the registry exposes registered partners and their stakes. The output includes ownership descriptions exactly as recorded in the register.
get_document_metadata and fetch_document
Return the signed PDF extract of the official register record. Two variants exist: the current extract (aktualny) and the full historical extract (pelny).
Responses are JSON, with most underlying fields mapped directly from the official KRS XML structures.
What's paywalled, gated, or restricted
Although Poland publishes large parts of its corporate registry, several important datasets remain outside the public API surface.
Beneficial ownership
Poland’s UBO register is the Centralny Rejestr Beneficjentów Rzeczywistych (CRBR) maintained by the Ministry of Finance. It operates separately from KRS and currently has no stable public API accessible from most infrastructure environments.
Full filing documents
The court register exposes references to filings but not the underlying document bodies through a programmatic interface. The documents themselves are accessible via the separate eKRS portal and linked by deep URLs.
Charges and pledges
Security interests over movable property are recorded in a separate pledge register with only a web interface.
Joint‑stock shareholder registers
For S.A. entities, shareholders are not published in the KRS dataset because they are held in the company’s private share book or by the central securities depository.
OpenRegistry coverage for Poland
| Tool | Status | Notes |
|---|---|---|
| search_companies | ✅ live | free‑text search and ID lookup |
| get_company_profile | ✅ live | full statutory record |
| list_filings | ✅ live | filing references (not document bodies) |
| get_officers | ✅ live | officers with masked personal identifiers |
| get_shareholders | ✅ live | partners and stakes for eligible legal forms |
| get_document_metadata | ✅ live | metadata for official PDF extracts |
| fetch_document | ✅ live | retrieves signed register extract |
| get_persons_with_significant_control | ⛔ 501 | CRBR register separate from KRS |
| get_charges | ⛔ 501 | pledges register has no programmatic access |
Country‑specific quirks
Identifier formats
Polish entities use several identifiers depending on registry context. KRS numbers are 10 digits. REGON identifiers are 9 digits for legal entities and 14 digits for local units. NIP (tax ID) numbers are also commonly used in searches.
Masked personal data
Natural‑person fields such as PESEL identifiers and portions of names are masked in the registry output. Corporate entity names appear in full.
Separate statistical register
Many profile fields come from the GUS REGON statistical register rather than the court register itself. Integrators should expect combined datasets.
Filing references without documents
The registry returns filing references but not the PDF or XBRL documents themselves. The API therefore returns links to the external portal where the document can be retrieved manually.
Worked example
Let’s query the Polish e‑commerce company Allegro using its KRS identifier 0000635012.
Example request
search_companies
jurisdiction: PL
query: "0000635012"
Example response (simplified)
{
"company_number": "0000635012",
"company_name": "Allegro sp. z o.o.",
"status": "active",
"registry": "Krajowy Rejestr Sądowy",
"registered_address": "Poznań, Poland"
}
We can then fetch the full statutory record:
get_company_profile
jurisdiction: PL
company_number: "0000635012"
The response includes the company’s legal form, address, PKD activity codes, board members, supervisory board information and filing references recorded in the KRS.
Connecting an MCP client
Add the OpenRegistry hosted server to an MCP client such as Claude Desktop or Cursor:
{
"mcpServers": {
"openregistry": {
"url": "https://openregistry.sophymarine.com/mcp"
}
}
}
Once connected, the tools above become available to agents and developer workflows.
Try it yourself
The OpenRegistry web interface exposes a live profile for the example company used above.
https://openregistry.sophymarine.com/company/PL/0000635012
The hosted MCP server provides a free anonymous tier with rate‑limited access to every jurisdiction supported by the platform.
OpenRegistry's full coverage
OpenRegistry is a free remote MCP server giving AI agents real‑time access to company‑registry data from 28 national governments. This article focused on Poland; the same toolkit covers:
UK Companies House · Ireland CRO · Australia ABR · Switzerland Zefix · Norway Brreg · France Sirene/RNE · Finland PRH · Czechia ARES · Poland KRS · Taiwan GCIS · Canada Corporations Canada · Canada BC Registries · Canada Northwest Territories CROS · Belgium KBO · Isle of Man Companies Registry · Iceland RSK · Liechtenstein Handelsregister · New Zealand Companies Office · Monaco RCI · Italy Registro Imprese · Spain BORME · Hong Kong Companies Registry · Malaysia SSM · South Korea OPENDART · Cyprus DRCOR · Mexico PSM · Cayman Islands CIMA · Russia EGRUL
→ Hosted MCP endpoint: https://openregistry.sophymarine.com/mcp
→ Docs: https://openregistry.sophymarine.com/docs/
→ Free anonymous tier: 20 req/min, all tools, every jurisdiction.
Made by Sophymarine.
Top comments (0)