Poland - Topograph

This guide is outdated and will be removed on 1 November 2026. The up-to-date Poland reference is on the Poland country page.

Start here

This guide contains public integration notes for Poland. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.

Poland coverage, pricing, and sources

Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.

Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.

Data Sources

Poland uses a hybrid approach across three registers, routing company lookups based on entity type. For a given entity, data comes from a single source determined by the registration prefix and by which register actually holds the entity.

KRS companies (legal entities)

KRS (Krajowy Rejestr Sadowy / National Court Register). Operated by the Ministry of Justice, the KRS is the primary source for all legal entities: limited liability companies (sp. z o.o.), joint-stock companies (S.A.), partnerships, associations, foundations, cooperatives, and other registered entities. Provides company name, legal form, status, address, capital, activity codes (PKD), management board members, procurators, and shareholders (sp. z o.o. only).
CRBR (Centralny Rejestr Beneficjentow Rzeczywistych / Central Register of Beneficial Owners). Poland’s official UBO registry, mandatory for all entities registered in KRS. Provides ultimate beneficial owner data including ownership percentages, control types (direct/indirect), and management positions. Accessed programmatically.
eKRS Financial Documents Portal (ekrs.ms.gov.pl). Official portal for financial documents filed by KRS companies. Provides annual financial statements, consolidated statements, management reports, auditor opinions, and approval resolutions. Documents may be in XML format (automatically converted to PDF).

CEIDG sole proprietors (individual businesses)

biznes.gov.pl API. Government API for the Central Register and Information on Business Activity (CEIDG). Used for search across both registers (KRS + CEIDG) and as the sole data source for sole proprietors. Provides company name, owner name, address, PKD activity codes, status, and basic contact information.

Entities in neither register

REGON (Krajowy rejestr urzedowy podmiotow gospodarki narodowej / National Official Business Register). The statistical register maintained by Statistics Poland (GUS), queried through its BIR1.2 API. Entry is compulsory for every entity in the national economy, so REGON is the only Polish register covering entities that appear in neither KRS nor CEIDG — civil-law partnerships (spolka cywilna) above all, plus housing communities, foreign representative offices, schools and public-administration bodies. Provides legal name, short name, legal form, registered seat, PKD activity codes, registration and closure dates, and a phone number where the entity declared one. REGON is used only when KRS and CEIDG both return nothing: for anything either of them holds, they are the richer source.

VAT validation

VIES (EU VAT Information Exchange System). In verification mode, the Polish VAT number (PL + NIP) is validated against VIES, with a qualified consultation number when the entity is VAT-registered.

Three registers, one entity model: KRS covers legal entities (companies, non-profits, cooperatives), CEIDG covers sole proprietors, and REGON covers everything — including the entities the other two structurally cannot hold. Our system uses prefixed identifiers (krs- / nip-) to route requests, and falls back to REGON when neither entrepreneur register recognises the identifier.

REGON is not an ownership source. It is a statistical register: it publishes an entity’s identity, not who owns or represents it. Beneficial owners come from CRBR and representatives from KRS or CEIDG, so a company served from REGON returns identity fields only.

How does the API choose between KRS and CEIDG?

krs-{number} prefix: Routes to the KRS API. Used for all legal entities registered in the National Court Register (companies, associations, foundations, cooperatives).
nip-{number} prefix: Routes to the biznes.gov.pl API. Used for sole proprietors registered in CEIDG.

The prefix is required because both KRS and NIP numbers are 10-digit identifiers that could collide. Not all KRS entities have a NIP (e.g., some associations and foundations), making KRS the only reliable identifier for those entities.Key Takeaway: Always use the appropriate prefix when querying. Search results from the API already include the correct prefix.

How is a spolka cywilna (civil-law partnership) handled?

A spolka cywilna is not a separate legal entity under Polish law, so it is registered in neither KRS nor CEIDG — but it does hold its own NIP and REGON, and it is entered in the REGON register with its own name, legal form, seat and PKD codes.

Search by the partnership’s NIP or REGON returns the partnership itself, from REGON. It also returns the individual partners, resolved from their CEIDG entries, with matchType: partialId — those results describe the partners, not the partnership.
Company lookups using the partnership’s nip- identifier return its identity from REGON.
Liability sits with the partners, so a spolka cywilna has no share capital and no representatives of its own to return.

Company Identifiers

company.identifiers.euid is an optional European Unique Identifier. Domestic sp. z o.o. and S.A. companies with a KRS number. Example: PLKRS.0000028860. It is returned as an output identifier and cannot be used as a search input. See EUID coverage and interpretation.

Query Identifiers

Company Type	Source	Format	Example	Notes
KRS legal entities	KRS	`krs-` + 10 digits	`krs-0001010154`	Padded with leading zeros
CEIDG sole proprietors	CEIDG	`nip-` + 10 digits	`nip-9511901401`	NIP (tax identification number)

Prefixed identifiers are required. Company IDs must use krs- or nip- prefixes to route to the correct register. Without a prefix, the system cannot determine the data source and will return an error.

KRS Number Padding: KRS numbers are always 10 digits with leading zeros (e.g., 0001010154). When searching by KRS number, shorter inputs are automatically padded to 10 digits.

Identifiers in API Response

Once you retrieve company data, the identifiers object contains all available identifiers for that entity:

Identifier Type	Format	Example	Found In
`krs`	10 digits	`0001010154`	KRS legal entities only
`nip`	10 digits, the last one a check digit	`7740001454`	Most KRS entities and all CEIDG entities
`regon`	9 digits (or 14 for branches)	`003295237`	Most entities across both registers
`VAT`	10 digits (same as NIP)	`7740001454`	Entities with NIP

Legal Entity Identifier (LEI)

GLEIF is the supplementary data source for this identifier. company.identifiers.lei is optional. It is returned when the KRS number (krs) matches exactly one LEI through a GLEIF registration or validation reference. The Legal Entity Identifier has 20 uppercase alphanumeric characters, ending in two check digits. Coverage varies by entity. An absent lei does not prove that the company has no LEI. Lapsed, retired or merged LEIs may be returned; annulled LEIs are excluded.

Search Capabilities

Search Type	Pattern	Example	Match Type	Expected Results
By KRS Number	1-10 digits	`0001010154`	Exact	Exact match returned first (matchType: id); other results may follow
By NIP Number	10 digits	`7740001454`	Not guaranteed unique	`matchType: partialId`. Usually one result, but a NIP can be shared by several KRS entities (see the note below)
By REGON Number	9 or 14 digits	`003295237`	Not guaranteed unique	`matchType: partialId`. Resolves entities in both registers; a REGON can also be shared by several KRS entities, a 9-digit REGON can be the prefix of a 14-digit one, and a 14-digit local-unit REGON resolves to its parent entity
By Name	Text string	`"Topograph"`	Contains	Multiple results across KRS + CEIDG

Search Performance: Use identifier-based searches (KRS, NIP, REGON) for best performance. The KRS number is the only one guaranteed to identify a single entity. Name searches query biznes.gov.pl and may return multiple results from both KRS and CEIDG registers.

Search queries multiple sources in parallel. For identifier searches, the system queries KRS by KRS number, KRS by NIP, KRS by REGON, CEIDG by NIP, CEIDG by REGON, and the REGON statistical register simultaneously. Results are deduplicated by ID, with KRS results taking precedence over CEIDG when both match. REGON results are used only when no other register recognises the identifier, so an ordinary company is never returned twice.

A NIP or REGON can return several companies. Only the KRS number identifies exactly one entity. When a business reorganises through successive legal entities it keeps its tax (NIP) and statistical (REGON) numbers, so those can be shared across several KRS entries — typically one active company plus one or more struck-off predecessors. Searching NIP 7622006714 or REGON 38186693900000, for example, returns three companies.Those results carry matchType: partialId rather than id, and each one has its own id (krs-…). Always pass the id from the search result to /v2/company, never the NIP or REGON, and retrieve the company data to establish which entity is current — search results do not carry company status.

Active companies only

Search can return companies that are no longer active. activeOnly=true removes those whose status is known at search time; the others are kept. Sole traders are filtered by their register status. Companies in the court register are returned whatever their status, because search does not report it.

Company Status

Company status is determined from KRS register data and enhanced with AI mapping. CEIDG (sole proprietor) statuses use a separate mapping path.

KRS Companies (primary path)

Status is derived from multiple KRS data points: deletion indicators, bankruptcy proceedings, merger records, and name-based liquidation detection.

Local Status (Polish)	English	Standardized Status	Detection Method
AKTYWNA	Active	Active	Default (no closure indicators)
W LIKWIDACJI	In Liquidation	Closed	Company name contains “W LIKWIDACJI”
WYKREŚLONA Z REJESTRU	Deleted from Register	Closed	Deletion entries in the KRS extract
W UPADŁOŚCI	In Bankruptcy	Under Insolvency Proceeding	Bankruptcy announced but not completed
UPADŁOŚĆ ZAKOŃCZONA	Bankruptcy Completed	Closed	Bankruptcy proceedings have completion date
PRZEJĘTA PRZEZ INNĄ SPÓŁKĘ	Acquired by Another Company	Closed	Merger/acquisition records in the KRS extract
DZIAŁALNOŚĆ ZAWIESZONA	Activity Suspended	Under Insolvency Proceeding	Suspension date present without resumption

Closure reasons (when status is Closed or Under Insolvency Proceeding):

Scenario	Standardized Closure Reason
Deletion from KRS/RP register	Administrative Dissolution
Bankruptcy proceedings	Bankruptcy
Liquidation (name-based detection)	Liquidation
Merger/acquisition	Merger

Prefill mode uses a lighter, deterministic mapping. It reads the register’s entity record instead of the full extract, with no AI step. A struck-off company returns WYKREŚLONY with closure reason Liquidation, a suspended company returns DZIAŁALNOŚĆ ZAWIESZONA, and any other company returns AKTYWNY. Verification mode uses the same mapping for a struck-off company whose current extract the register no longer issues.

CEIDG Sole Proprietors

Local Status (Polish)	English	Standardized Status	Closure Reason
AKTYWNY	Active	Active
WYLACZNIE_W_FORMIE_SPOLKI	Trading only as a partner of a civil-law partnership	Active
ZAWIESZONY	Suspended	Inactive Not Closed
WYKRESLONY	Deleted	Closed	Voluntary Dissolution

Closure Date Priority

The system prioritizes closure dates in the following order:

Deletion finalization date in the KRS extract header (highest priority)
Register deletion dates from the KRS deletion records
Bankruptcy completion date
CEIDG cancellation/cessation dates (for sole proprietors)

In verification mode, KRS status classification is AI-enhanced. The local Polish status name from KRS is always preserved verbatim. The AI analyzes the status in context to provide standardized mapping. Deterministic rules (deletion, bankruptcy, liquidation) take precedence before AI enrichment.

Legal Forms

Poland ships a closed enum of 102 legal forms sourced directly from the Polish registers: 51 forms the KRS returns, one canonical entry for CEIDG sole traders, and 50 forms from the REGON statistical register for entities held in neither KRS nor CEIDG. There is no AI fallback: an unknown value is rejected with invalid at ingestion time so the enum stays accurate and any new form the register introduces surfaces as a deploy blocker. Provenance:

KRS values were harvested from the full July 2024 snapshot of the Krajowy Rejestr Sadowy (849,757 entities across the commercial register RejP and the association register RejS). The top 13 forms cover 99.7% of the register and the full set is 50 distinct strings. A 51st form, the branch of a foreign entrepreneur, was added in July 2026 after live register responses returned it.
CEIDG sole traders are projected onto a single canonical entry (Osoba fizyczna prowadząca działalność gospodarczą), because the biznes.gov.pl API does not expose a formaPrawna field for CEIDG entries (a sole trader has no entity-level legal form under Polish law).
REGON values come from the closed szczególna forma prawna dictionary published by Statistics Poland (GUS). Only the forms that KRS and CEIDG do not already cover are added, chiefly entities registered only in REGON: civil-law partnerships, housing communities, foreign representative offices, schools and public-administration bodies.
ISO 20275 (ELF) codes are attached as a cross-reference where GLEIF publishes one. Out of the 102 entries, 44 have an ELF code: 43 of the 51 KRS forms and the CEIDG entry. None of the REGON-only forms has one. GLEIF is not the source of the enum; the register is. We attach ELF codes opportunistically for LEI matching and nothing more.

GLEIF’s ISO 20275 list for Poland is incomplete and is not a safe source of truth. 8 of the 51 KRS forms have no ELF code at all (for example the granular stowarzyszenie subtypes, public-benefit organizations without a church link, and branches of foreign entrepreneurs). This is why the enum is built from the register itself, not from ISO 20275.

Core commercial forms

Polish Name	Abbr.	English Translation	Standardized	ISO 20275
Spółka z ograniczoną odpowiedzialnością	sp. z o.o.	Limited Liability Company	Limited Liability Company	O7XB
Spółka akcyjna	S.A.	Joint-Stock Company	Corporation	FJ0E
Prosta spółka akcyjna	P.S.A.	Simple Joint-Stock Company	Corporation	B21W
Spółka jawna	sp.j.	General Partnership	Partnership	629I
Spółka komandytowa	sp.k.	Limited Partnership	Partnership	BSJT
Spółka komandytowo-akcyjna	S.K.A.	Limited Joint-Stock Partnership	Partnership	OMX0
Spółka partnerska	sp.p.	Professional Partnership	Partnership	3BJG
Spółka europejska	SE	European Company	Corporation	J3A3
Europejskie zgrupowanie interesów gospodarczych	EEIG	European Economic Interest Grouping	Partnership	85PM

Cooperatives and mutuals

Polish Name	English Translation	Standardized	ISO 20275
Spółdzielnia	Cooperative	Cooperative	8TOF
Spółdzielnia europejska	European Cooperative Society (SCE)	Cooperative	(no ELF)
Spółdzielcza kasa oszczędnościowo-kredytowa	Credit Union (SKOK)	Cooperative	H7OD
Towarzystwo ubezpieczeń wzajemnych	Mutual Insurance Society (TUW)	Cooperative	WNX1

State and public-sector entities

Polish Name	English Translation	Standardized	ISO 20275
Przedsiębiorstwo państwowe	State-Owned Enterprise	Government-Owned Entity	SMIS
Instytut badawczy (including Łukasiewicz Research Network)	Research Institute	Government-Owned Entity	KM66
Instytucja gospodarki budżetowej	Budgetary Institution	Government-Owned Entity	CY1M
Samodzielny publiczny zakład opieki zdrowotnej	Independent Public Healthcare Institution (SPZOZ)	Government-Owned Entity	13ZV

Associations and foundations

Polish Name	English Translation	Standardized	ISO 20275
Stowarzyszenie	Association	Nonprofit Organization	ZZKE
Związek stowarzyszeń	Union of Associations	Nonprofit Organization	ZZKE
Jednostka terenowa stowarzyszenia posiadająca osobowość prawną	Regional Unit of an Association with Legal Personality	Nonprofit Organization	(no ELF)
Stowarzyszenie kultury fizycznej	Sports Association	Nonprofit Organization	(no ELF)
Stowarzyszenie kultury fizycznej o zasięgu ogólnokrajowym	Nationwide Sports Association	Nonprofit Organization	(no ELF)
Stowarzyszenie ogrodowe	Gardening Association	Nonprofit Organization	(no ELF)
Fundacja	Foundation	Nonprofit Organization	96XK

Trade unions and employer associations

Polish Name	English Translation	Standardized	ISO 20275
Związek zawodowy	Trade Union	Nonprofit Organization	LT9U
Jednostka organizacyjna związku zawodowego posiadająca osobowość prawną	Organizational Unit of a Trade Union	Nonprofit Organization	LT9U
Związek zawodowy rolników indywidualnych	Individual Farmers Trade Union	Nonprofit Organization	LT9U
Ogólnokrajowy związek międzybranżowy	National Inter-Industry Union	Nonprofit Organization	WOK7
Związek pracodawców	Employers Association	Nonprofit Organization	WOK7
Federacja / Konfederacja związków pracodawców	Federation or Confederation of Employer Associations	Nonprofit Organization	WOK7

Guilds, chambers, and business organizations

Polish Name	English Translation	Standardized	ISO 20275
Cech rzemieślniczy	Guild of Craftsmen	Nonprofit Organization	5F76
Izba rzemieślnicza	Chamber of Crafts	Nonprofit Organization	5F76
Związek Rzemiosła Polskiego	Polish Crafts Union	Nonprofit Organization	5F76
Izba gospodarcza	Chamber of Commerce	Nonprofit Organization	5F76
Inna organizacja podmiotów gospodarczych	Other Business Entity Organization	Nonprofit Organization	FQ5Y
Inna organizacja społeczna lub zawodowa	Other Social or Professional Organization	Nonprofit Organization	FQ5Y

Agricultural and transport associations

Polish Name	English Translation	Standardized	ISO 20275
Kółko rolnicze	Farmers Circle	Nonprofit Organization	FANM
Rolnicze zrzeszenie branżowe	Agricultural Branch Association	Nonprofit Organization	6OYI
Związek rolniczych zrzeszeń branżowych	Union of Agricultural Branch Associations	Nonprofit Organization	6OYI
Związki rolników, kółek i organizacji rolniczych	Unions of Farmers and Farmers Circles	Nonprofit Organization	WOK7
Zrzeszenie handlu i usług	Trade and Services Association	Nonprofit Organization	6OYI
Ogólnokrajowa reprezentacja zrzeszeń handlu i usług	National Representation of Trade Associations	Nonprofit Organization	6OYI
Zrzeszenie transportu	Transport Association	Nonprofit Organization	6OYI
Ogólnokrajowe zrzeszenie międzybranżowe	National Inter-Industry Association	Nonprofit Organization	6OYI

Sports bodies

Polish Name	English Translation	Standardized	ISO 20275
Związek sportowy	Sports Union	Nonprofit Organization	WOK7
Polski związek sportowy	Polish Sports Union	Nonprofit Organization	WOK7

Public-benefit organizations and church entities

Polish Name	English Translation	Standardized	ISO 20275
Inna osoba prawna będąca organizacją pożytku publicznego	Other Legal Person Acting as a Public Benefit Organization	Nonprofit Organization	(no ELF)
Nieposiadająca osobowości prawnej organizacja pożytku publicznego	Public Benefit Organization without Legal Personality	Nonprofit Organization	(no ELF)
Kościelna osoba prawna będąca organizacją pożytku publicznego	Church Legal Person Acting as a Public Benefit Organization	Nonprofit Organization	SP4S
Nieposiadająca osobowości prawnej instytucja kościelna będąca organizacją pożytku publicznego	Church Institution without Legal Personality Acting as a Public Benefit Organization	Nonprofit Organization	SP4S

Foreign branches (KRS)

Polish Name	English Translation	Standardized	ISO 20275
Oddział zagranicznego przedsiębiorcy	Branch of a Foreign Entrepreneur	Branch or Representative Office	(no ELF)

Sole traders (CEIDG)

Polish Name	English Translation	Standardized	ISO 20275
Osoba fizyczna prowadząca działalność gospodarczą	Sole Trader (CEIDG)	Sole Proprietorship	ZVVM

Entities registered only in REGON

These forms have no ISO 20275 code.

Polish Name	English Translation	Standardized
Spółka cywilna	Civil-Law Partnership (s.c.)	Partnership
Spółka przewidziana w przepisach innych ustaw niż Kodeks spółek handlowych i Kodeks cywilny	Company Established under Statutes Other than the Commercial Companies Code or the Civil Code	Other
Uczelnia	Higher Education Institution	Other
Fundusz	Fund	Other
Kościół Katolicki	Catholic Church	Nonprofit Organization
Inny kościół lub związek wyznaniowy	Other Church or Religious Association	Nonprofit Organization
Europejskie ugrupowanie współpracy terytorialnej	European Grouping of Territorial Cooperation (EGTC)	Other
Stowarzyszenie niewpisane do KRS	Association Not Entered in the KRS	Nonprofit Organization
Organizacja społeczna oddzielnie niewymieniona, niewpisana do KRS	Social Organization Not Otherwise Specified, Not Entered in the KRS	Nonprofit Organization
Partia polityczna	Political Party	Nonprofit Organization
Samorząd gospodarczy lub zawodowy niewpisany do KRS	Trade or Professional Self-Government Body Not Entered in the KRS	Nonprofit Organization
Przedstawicielstwo zagraniczne	Foreign Representative Office	Branch or Representative Office
Wspólnota mieszkaniowa	Housing Community	Other
Towarzystwo reasekuracji wzajemnej	Mutual Reinsurance Society	Cooperative
Główny oddział zagranicznego zakładu reasekuracji	Main Branch of a Foreign Reinsurance Undertaking	Branch or Representative Office
Główny oddział zagranicznego zakładu ubezpieczeń	Main Branch of a Foreign Insurance Undertaking	Branch or Representative Office
Jednostka badawczo-rozwojowa	Research and Development Unit	Government-Owned Entity
Kolumna transportu sanitarnego	Medical Transport Column	Government-Owned Entity
Ogólnokrajowa reprezentacja zrzeszeń transportu	Nationwide Representation of Transport Associations	Nonprofit Organization
Przedsiębiorstwo zagraniczne	Foreign-Owned Enterprise	Other
Związek stowarzyszeń ogrodowych	Union of Gardening Associations	Nonprofit Organization
Przedszkole publiczne	Public Preschool	Government-Owned Entity
Przedszkole niepubliczne	Non-Public Preschool	Other
Publiczna szkoła podstawowa	Public Primary School	Government-Owned Entity
Publiczne gimnazjum	Public Lower-Secondary School	Government-Owned Entity
Publiczna szkoła ponadpodstawowa	Public Upper-Secondary School	Government-Owned Entity
Publiczna szkoła ponadgimnazjalna	Public Post-Lower-Secondary School	Government-Owned Entity
Publiczna szkoła artystyczna	Public Arts School	Government-Owned Entity
Niepubliczna szkoła podstawowa	Non-Public Primary School	Other
Niepubliczne gimnazjum	Non-Public Lower-Secondary School	Other
Niepubliczna szkoła ponadpodstawowa	Non-Public Upper-Secondary School	Other
Niepubliczna szkoła ponadgimnazjalna	Non-Public Post-Lower-Secondary School	Other
Niepubliczna szkoła artystyczna	Non-Public Arts School	Other
Publiczna placówka systemu oświaty	Public Education-System Establishment	Government-Owned Entity
Niepubliczna placówka systemu oświaty	Non-Public Education-System Establishment	Other
Inna publiczna jednostka organizacyjna systemu oświaty	Other Public Education-System Organizational Unit	Government-Owned Entity
Inna niepubliczna jednostka organizacyjna systemu oświaty	Other Non-Public Education-System Organizational Unit	Other
Publiczny zespół szkół i placówek systemu oświaty	Public Complex of Schools and Education-System Establishments	Government-Owned Entity
Niepubliczny zespół szkół i placówek systemu oświaty	Non-Public Complex of Schools and Education-System Establishments	Other
Organ władzy lub administracji rządowej	Public Authority or Government Administration Body	Government-Owned Entity
Organ kontroli państwowej i ochrony prawa	State Audit or Law Enforcement Body	Government-Owned Entity
Wspólnota samorządowa	Local Government Community	Government-Owned Entity
Sąd lub trybunał	Court or Tribunal	Government-Owned Entity
Skarb Państwa	State Treasury	Government-Owned Entity
Państwowa jednostka organizacyjna	State Organizational Unit	Government-Owned Entity
Gminna samorządowa jednostka organizacyjna	Municipal Local-Government Organizational Unit	Government-Owned Entity
Powiatowa samorządowa jednostka organizacyjna	County Local-Government Organizational Unit	Government-Owned Entity
Wojewódzka samorządowa jednostka organizacyjna	Voivodeship Local-Government Organizational Unit	Government-Owned Entity
Inna państwowa lub samorządowa osoba prawna	Other State or Local-Government Legal Person	Government-Owned Entity
Bez szczególnej formy prawnej	No Special Legal Form	Other

Legal Representatives

For KRS entities, legalRepresentatives covers the management board and the procurators only. Supervisory board members are not included. Known Polish role labels use the published translations and standardized values. Extraction and ISO 5009 matching may still use AI. Joint or sole signing follows the representation rule in the extract.

Board member and shareholder names: use verification mode. Poland’s National Court Register masks personal data on its online lookup, returning names like W***** L********. Topograph reads the full names from the official court extract instead, so in verification mode legalRepresentatives and shareholders come back with complete first names and surnames for companies, associations, and foundations. The names are read from the court extract by AI, so verify against the source document before relying on them for compliance.Details for the response payload:

Prefill mode returns only the company identity fields (name, legal form, registered seat, status, dates). It does not include board members or shareholders, and for companies in the National Court Register it does not include share capital or activity codes either. Use verification mode (the default) when you need them.
legalRepresentatives[].individual.name.firstName and lastName are full and unredacted in verification mode.
legalRepresentatives[].individual.birthDate and gender are not currently populated for Polish entities.
shareholders are listed for limited liability companies (sp. z o.o.) where the register publishes them, with full names.
The role (localName and standardized), structural fields, addresses, capital, and dates are all complete.

The ultimate beneficial owners datapoint comes from CRBR, a separate Polish register, with full names, birth dates, and nationalities. UBOs and legal representatives answer different questions and one is not a substitute for the other.

KRS Management Board Roles

Management Board Roles (Zarzad)

Polish Role	English Translation	Standardized Role
PREZES ZARZĄDU	President of the Management Board	President
WICEPREZES ZARZĄDU	Vice President of the Management Board	Vice President
CZŁONEK ZARZĄDU	Management Board Member	Board Member

Procurator Roles (Prokura)

Polish Role	English Translation	Standardized Role
PROKURENT	Procurator	Authorized Signatory
PROKURA SAMOISTNA	Procurator with Sole Signing Authority	Authorized Signatory
PROKURA ŁĄCZNA	Procurator with Joint Signing Authority	Authorized Signatory

CEIDG Owner Role

Polish Role	English Translation	Standardized Role
Wlasciciel	Owner	Owner

PESEL, Birth Date and Gender

The PESEL (Polish Personal Identification Number) of KRS management board members and procurators is sensitive personal data and is not part of the response. birthDate and gender are not currently populated for Polish legal representatives. Full names are returned in verification mode (see the note above).

Procurators (authorized signatories) from KRS are mapped as additional legal representatives with the original Polish prokura label and standardized as Authorized Signatory. For CEIDG sole proprietors, the entrepreneur is automatically mapped as the sole legal representative with role “Wlasciciel” (Owner).

Other Key Persons

Other key persons are not currently extracted from Polish registries. All management board members and procurators are mapped as legal representatives.

Shareholders

Shareholders are available for sp. z o.o. (Limited Liability Companies) in verification mode. They are read by AI from the shareholders section (“Wspólnicy”) of the official KRS court extract, with full names for individuals and, for corporate shareholders, the company name and its Polish identifiers (KRS, NIP, REGON) when shown. Verify against the source document before relying on them for compliance. The court extract lists the number and value of shares each shareholder holds, not a percentage. When two or more shareholders are listed and every one of them has a share count, sharePercentage is derived in proportion to those counts. The register only lists shareholders holding at least 10% of the share capital, so a derived percentage is relative to the listed shareholders.

Limitations

Legal Form	Shareholder Data Available?	Notes
sp. z o.o. (LLC)	Yes	Individual and corporate shareholders with share counts
S.A. (Joint-Stock)	No	Shareholders not listed in public KRS register
sp.k. / sp.j. (Partnerships)	No	Partner data not structured in shareholder format
Associations / Foundations	No	Not applicable
CEIDG (Sole Proprietors)	No	Not applicable

For corporate shareholders, Polish identifiers (KRS, NIP, REGON) are included when available. Foreign corporate shareholders without Polish identifiers are included with name only. KRS publishes share counts, not percentages; a percentage is only derived from the counts as described above.

Ultimate Beneficial Owners

UBO data is sourced from CRBR (Centralny Rejestr Beneficjentów Rzeczywistych), the Polish Central Register of Beneficial Owners operated by the Ministry of Finance. CRBR is a separate register from KRS, established under Polish AML law (transposing 4AMLD/5AMLD), and it is mandatory for almost every entity registered in KRS to disclose its beneficial owners there. A beneficial owner in CRBR is the natural person who ultimately owns or controls the entity, defined by the Polish AML act as direct or indirect ownership above 25%, or any other form of effective control. Where no natural person meets that threshold (typical for state-owned entities, listed companies, and complex structures), CRBR records senior managing officials as a fallback per the AML directive.

CRBR is not redacted. Unlike the KRS online lookup, CRBR returns full first names, surnames, birth dates, nationalities, and a description of how control is exercised. The redaction policy the Ministry of Justice applies to KRS does not apply to CRBR, because the whole point of CRBR is to expose this data for AML and KYC compliance.

Each UBO record returned by the API contains:

Field	Source	Notes
`name.firstName` / `lastName` / `fullName`	CRBR	Unredacted
`birthDate`	CRBR	Day, month, year
`nationality`	CRBR	ISO 3166-1 alpha-2
`control.types[]`	CRBR	`ownership-of-shares` or `significant-influence-or-control` (the latter also covers a senior management position)
`control.description`	CRBR	Polish-language description of how the control is exercised, as filed by the entity
`control.details[].nature`	CRBR	`direct`, `indirect`, or `unknown` when the filing uses an unrecognised form of control
`control.details[].monetaryAmount`	CRBR	When the filing expresses the stake as an amount instead of a percentage, always in PLN

CRBR returns no UBOs for entities that are exempt from disclosure (state-owned enterprises, the State Treasury, certain public-benefit organizations) or for entities whose ownership chain resolves to a listed parent. In those cases the response contains an empty ultimateBeneficialOwners array, which is correct, not a gap. UBO data is fetched on demand: include ultimateBeneficialOwners in the dataPoints array on POST /v2/company. The UBO extract document returns the full CRBR PDF excerpt for filing in compliance dossiers.

Activity Code Mapping

Poland uses PKD (Polska Klasyfikacja Dzialalnosci). The registers publish national codes under PKD in the source format (62.01.Z, division.class.subclass). PKD 2007 and PKD 2025 coexist during the official transition through 2026. The implemented KRS and REGON activity rows do not stamp the edition, so their codes are retained without a revision suffix or an assumed NACE conversion.

Classification	Source	Example	AI Inferred?
PKD	KRS, CEIDG or REGON	`62.02.Z`	No (official)
NACE / ISIC	CEIDG activity analysis, where available	Depends on the activity	Can be AI-inferred

The KRS provides both the main activity and secondary activities. CEIDG provides a primary PKD code and additional codes. REGON marks one code as the prevailing activity (dzialalnosc przewazajaca) as well. All three registers declare a prevailing activity, and it is always listed first. The PKD code the register declares as prevailing carries isMainActivity: true. Codes without the flag are not necessarily secondary: the flag is only set when the register explicitly declares the main activity.

AI Enrichment: Every activity item includes an isAIInferred flag. PKD codes are never AI-inferred for Poland. For CEIDG sole proprietors, ISIC codes are matched from the PKD codes by an LLM and NACE is derived from them, so those items can carry isAIInferred: true.

Activity Codes by Source

Source	Classifications returned	Notes
KRS	PKD	Main and additional native PKD codes; edition not stated by the activity input
REGON	PKD	Native code and source wording, prevailing activity first; edition not stated
CEIDG	PKD + NACE + ISIC	Primary and additional PKD codes, AI-analyzed

Data Availability Matrix

Data Type	KRS Companies	CEIDG (Sole Proprietors)	Notes
Company Profile	Async	Async	Full data for KRS, limited for CEIDG
Legal Representatives	Yes (verification mode, full names)	Yes	KRS: management board and procurators, read from the official court extract. CEIDG: owner mapped from CEIDG metadata.
Shareholders	Yes (sp. z o.o., verification mode, full names)	No	Only for Limited Liability Companies, read from the official court extract. Corporate shareholders include their Polish identifiers (KRS, NIP, REGON) when shown.
Other Key Persons	No	No	Not currently extracted
Ultimate Beneficial Owners	Yes	No	From CRBR (Central Register of Beneficial Owners)
Activity Codes	Yes	Yes	PKD codes from KRS or CEIDG
Documents	Yes	Yes	Different document sets per register type
Financial Statements	Yes	No	From ekrs.ms.gov.pl, automatic XML-to-PDF conversion
Establishments	No	No	Not currently extracted

Legend: Yes = Available | No = Not Available | Async = Asynchronous processing

Documents by Company Type

KRS Companies (prefix: `krs-`)

Document Type	API Category	Format	Availability	Notes
Current KRS Extract	`tradeRegisterExtract`	PDF	Active companies only	Aktualny odpis z KRS
Historical KRS Extract	`otherDocuments[]`	PDF	All companies	Pelny odpis historyczny z KRS (full history)
UBO Extract	`ultimateBeneficialOwnersCertificate`	PDF	When UBO data exists	Wyciag z CRBR o beneficjentach rzeczywistych
Financial Statements	`financialStatements[]`	PDF (auto-converted from XML)	When filed	Annual and consolidated annual financial statements from ekrs.ms.gov.pl
Other eKRS filings	`otherDocuments[]`	PDF (auto-converted from XML)	When filed	Management reports, auditor opinions, and resolutions from ekrs.ms.gov.pl

CEIDG Sole Proprietors (prefix: `nip-`)

Document Type	API Category	Format	Availability	Notes
CEIDG Certificate	`tradeRegisterExtract`	PDF	All entities	Zaswiadczenie z CEIDG
Representatives Document	`otherDocuments[]`	PDF	All entities	Informacja o pelnomocnikach

Current KRS Extract availability: The current extract (tradeRegisterExtract) is only available for active companies. Inactive, dissolved, or deleted companies can only access the historical extract (otherDocuments[]), which contains the full history including closure details.

Financial Document Types

Available financial document types from the eKRS portal include the following. Annual and consolidated annual financial statements are returned under financialStatements[]; every other filing is returned under otherDocuments[].

Roczne sprawozdanie finansowe — Annual Financial Statements
Skonsolidowane roczne sprawozdanie finansowe — Consolidated Annual Financial Statements
Sprawozdanie z dzialalnosci — Management Reports
Opinia bieglego rewidenta — Auditor’s Opinions
Uchwaly o zatwierdzeniu sprawozdan — Approval Resolutions
Uchwaly o podziale zysku — Profit Distribution Resolutions

Automatic XML-to-PDF Conversion: Financial documents in Poland are often published in XML format using the Ministry of Finance schema. We automatically convert these XML files to human-readable PDF format using the official Polish government visualization tool at e-sprawozdania.mf.gov.pl. Both the original XML and the converted PDF are stored and accessible. If conversion fails, the original XML file is still returned.

Due to technical limitations of the Polish financial documents portal, the document format (XML vs PDF) is not available in the availableDocuments listing. The format field will be undefined during listing and is only determined when the document is actually downloaded.

Example API Responses

All examples use placeholder data. Query: POST /v2/company with { "id": "<id>", "countryCode": "PL", "dataPoints": ["company", "legalRepresentatives"] }

Active sp. z o.o. (KRS Company) -- with Shareholders

{
  "company": {
    "id": "krs-0001234567",
    "countryCode": "PL",
    "identifiers": { "krs": "0001234567", "nip": "1234567890", "regon": "123456789", "VAT": "1234567890" },
    "legalName": "Przyklad Technologia sp. z o.o.",
    "registrationDate": "2018-03-20",
    "status": { "localName": "AKTYWNA", "active": true, "statusDetails": { "status": "ACTIVE" } },
    "legalForm": { "localName": "Spółka z ograniczoną odpowiedzialnością", "englishTranslation": "Limited Liability Company (sp. z o.o.)", "standardized": "Limited Liability Company", "iso20275Code": "O7XB" },
    "capital": { "amount": 50000, "currency": "PLN" },
    "activities": {
      "PKD": [
        { "code": "62.01.Z", "description": "DZIAŁALNOŚĆ ZWIĄZANA Z OPROGRAMOWANIEM", "isAIInferred": false, "isMainActivity": true },
        { "code": "62.02.Z", "description": "DZIAŁALNOŚĆ ZWIĄZANA Z DORADZTWEM W ZAKRESIE INFORMATYKI", "isAIInferred": false }
      ]
    },
    "legalAddress": { "addressLine1": "Aleja Jana Pawla II 29", "city": "Warszawa", "postalCode": "00-867", "countryCode": "PL" }
  },
  "legalRepresentatives": [
    { "entityId": "person_001", "type": "individual", "role": { "localName": "PREZES ZARZĄDU", "standardized": "President" }, "individual": { "name": { "fullName": "Jan Kowalski", "firstName": "Jan", "lastName": "Kowalski" } } },
    { "entityId": "person_002", "type": "individual", "role": { "localName": "CZŁONEK ZARZĄDU", "standardized": "Board Member" }, "individual": { "name": { "fullName": "Anna Nowak", "firstName": "Anna", "lastName": "Nowak" } } }
  ],
  "shareholders": [
    { "entityId": "person_001", "type": "individual", "individual": { "name": { "fullName": "Jan Kowalski", "firstName": "Jan", "lastName": "Kowalski" } }, "numberOfShares": 500, "sharePercentage": 50 },
    { "entityId": "company_001", "type": "company", "company": { "id": "krs-0009876543", "countryCode": "PL", "legalName": "Holding sp. z o.o.", "identifiers": { "krs": "0009876543" } }, "numberOfShares": 500, "sharePercentage": 50 }
  ]
}

Note: In verification mode, representative and shareholder names are read in full from the official court extract. sharePercentage is derived from the share counts of the listed shareholders. birthDate, gender and nationality are usually absent for KRS representatives, because the extract does not state them.

Closed KRS Company (Dissolved)

{
  "company": {
    "id": "krs-0007654321",
    "countryCode": "PL",
    "identifiers": { "krs": "0007654321", "nip": "9876543210", "regon": "987654321", "VAT": "9876543210" },
    "legalName": "Stara Firma S.A.",
    "registrationDate": "2005-01-10",
    "status": { "localName": "WYKREŚLONA Z REJESTRU", "active": false, "statusDetails": { "status": "CLOSED", "closureReason": "ADMINISTRATIVE_DISSOLUTION", "closureDate": "2023-06-30" } },
    "legalForm": { "localName": "Spółka akcyjna", "englishTranslation": "Joint-Stock Company (S.A.)", "standardized": "Corporation", "iso20275Code": "FJ0E" },
    "legalAddress": { "addressLine1": "Marszalkowska 10", "city": "Warszawa", "postalCode": "00-001", "countryCode": "PL" }
  },
  "legalRepresentatives": [
    { "entityId": "person_001", "type": "individual", "role": { "localName": "PREZES ZARZĄDU", "standardized": "President" }, "individual": { "name": { "fullName": "Piotr Wiśniewski", "firstName": "Piotr", "lastName": "Wiśniewski" } } }
  ],
  "shareholders": []
}

Note: For a company struck off the register, representatives and shareholders reflect the last position recorded before the strike-off, read from the full historical extract. Shareholders are only listed for limited liability companies (sp. z o.o.), so this joint-stock company example has none. Only the historical trade register extract is available as a document.

CEIDG Sole Proprietor

{
  "company": {
    "id": "nip-1234567890",
    "countryCode": "PL",
    "identifiers": { "nip": "1234567890", "regon": "123456789", "VAT": "1234567890" },
    "legalName": "Jan Kowalski Uslugi Informatyczne",
    "registrationDate": "2020-01-15",
    "status": { "localName": "AKTYWNY", "active": true, "statusDetails": { "status": "ACTIVE" } },
    "legalForm": { "localName": "Osoba fizyczna prowadząca działalność gospodarczą", "englishTranslation": "Sole Trader (CEIDG)", "standardized": "Sole Proprietorship", "iso20275Code": "ZVVM" },
    "activities": {
      "PKD": [
        { "code": "62.01.Z", "description": "Dzialalnosc zwiazana z oprogramowaniem" }
      ]
    },
    "legalAddress": { "addressLine1": "Krakowska 5", "city": "Krakow", "postalCode": "31-001", "countryCode": "PL" }
  },
  "legalRepresentatives": [
    { "entityId": "person_001", "type": "individual", "role": { "localName": "Wlasciciel", "englishTranslation": "Owner", "standardized": "Owner" }, "individual": { "name": { "fullName": "Jan Kowalski", "firstName": "Jan", "lastName": "Kowalski" }, "nationality": "PL" } }
  ],
  "shareholders": []
}

Note: CEIDG entities have the entrepreneur mapped as the sole legal representative with role “Wlasciciel” (Owner). No shareholders, UBOs, or financial statements are available.

UBO Response (dedicated datapoint)

Query with "dataPoints": ["ultimateBeneficialOwners"]:

{
  "ultimateBeneficialOwners": [
    {
      "entityId": "person_001",
      "name": { "fullName": "JAN KOWALSKI", "firstName": "JAN", "lastName": "KOWALSKI" },
      "birthDate": { "year": 1985, "month": 6, "day": 15 },
      "nationality": "PL",
      "control": {
        "types": ["ownership-of-shares"],
        "description": "WSPÓLNIK SPÓŁKI Z O.O. (2500 PLN)",
        "details": [
          {
            "nature": "direct",
            "type": "shares",
            "monetaryAmount": { "amount": 2500, "currency": "PLN", "formatted": "2500 PLN" }
          }
        ]
      }
    },
    {
      "entityId": "person_002",
      "name": { "fullName": "KLAUS RÖHRIG", "firstName": "KLAUS", "lastName": "RÖHRIG" },
      "birthDate": { "year": 1977, "month": 7, "day": 21 },
      "nationality": "AT",
      "control": {
        "types": ["significant-influence-or-control"],
        "description": "POŚREDNIA KONTROLA NAD PODMIOTEM DOMINUJĄCYM WOBEC SPÓŁKI",
        "details": [
          {
            "nature": "indirect",
            "type": "shares"
          }
        ]
      }
    }
  ]
}

Note: UBO records are unredacted and verified live. CRBR is operated by the Polish Ministry of Finance, not by the Ministry of Justice that runs KRS, and the redaction policy on KRS does not apply here. Note: UBOs are fetched from the CRBR (Central Register of Beneficial Owners). Three forms of control are recognized: (1) direct ownership of shares or assets (ownership-of-shares, nature direct), (2) indirect control through a controlling entity (significant-influence-or-control, nature indirect), and (3) a senior management position under AML law (significant-influence-or-control, nature direct). Ownership is expressed either as a percentage or as a monetary amount in PLN.

Available Documents (KRS Company)

Documents are returned when "dataPoints": ["availableDocuments"] is requested.For active KRS companies:

API Category	Document	Notes
`tradeRegisterExtract`	Aktualny odpis z KRS	Current extract, active companies only
`otherDocuments[]`	Pelny odpis historyczny z KRS	Full historical extract
`ultimateBeneficialOwnersCertificate`	Wyciag z CRBR	UBO extract, when UBO data exists
`financialStatements[]`	Annual and consolidated financial statements	From ekrs.ms.gov.pl
`otherDocuments[]`	Other eKRS filings	Management reports, auditor opinions, resolutions

For inactive KRS companies:

API Category	Document	Notes
`otherDocuments[]`	Pelny odpis historyczny z KRS	Full historical extract (only document available)

For CEIDG entities:

API Category	Document	Notes
`tradeRegisterExtract`	Zaswiadczenie z CEIDG	CEIDG certificate
`otherDocuments[]`	Informacja o pelnomocnikach	Representatives document

Quirks & Gotchas

Quirk	Details
Prefixed identifiers required	Company IDs must use `krs-` or `nip-` prefixes to route to the correct register. Without a prefix, the system returns an error.
KRS and NIP can collide	Both KRS and NIP are 10-digit numbers. The prefix system prevents ambiguity. Not all KRS entities have a NIP (e.g., associations, foundations).
Shareholders only for sp. z o.o.	Only Limited Liability Companies have shareholder data in KRS. Joint-stock companies, partnerships, and CEIDG entities do not expose shareholder information.
Share percentages are derived	KRS publishes share counts, not ownership percentages. When two or more shareholders are listed and all have a share count, `sharePercentage` is computed in proportion to those counts, relative to the listed shareholders only.
Liquidation detected from company name	Companies in liquidation are identified by “W LIKWIDACJI” appearing in the legal name, not from a dedicated status field in KRS.
Legal forms are a closed enum	Poland uses a closed enum of 102 legal forms sourced directly from the registers: 51 KRS forms (50 from the KRS July 2024 snapshot of 849,757 entities plus the foreign-branch form), one canonical CEIDG sole-trader entry, and 50 REGON-only forms. Unknown values are rejected with an `invalid` error at ingestion time. No AI fallback.
ISO 20275 is incomplete for Poland	44 of the 102 forms carry an ELF code. The other 58 have none: 8 KRS forms (granular `stowarzyszenie` subtypes, public-benefit organizations, foreign branches) and all 50 REGON-only forms. We attach ELF codes where they exist for LEI matching and ignore the gap elsewhere.
Procurators as legal representatives	Procurators (authorized signatories) from KRS are mapped as additional legal representatives with the original Polish prokura label, standardized as `Authorized Signatory`.
Financial documents may be XML	Financial statements from the Ministry of Finance portal may be in XML format. The system automatically converts XML to PDF, but the format is unknown until download.
CEIDG data is limited	CEIDG (sole proprietor) profiles have significantly less structured data than KRS companies. No shareholders, UBOs, or financial statements are available. The owner is mapped as the sole legal representative.
PKD edition is unstated	A national subclass (`62.01.Z`) is not a NACE code. KRS and REGON retain native `PKD`; no revision is inferred from code shape or filing date.
Struck-off companies show their last position	The register no longer issues a current extract for a struck-off company. Representatives and shareholders are read from the full historical extract and reflect the position in force immediately before the strike-off.
Current extract only for active companies	The Aktualny odpis z KRS (current trade register extract) is unavailable for closed/dissolved companies. Use the historical extract instead.
UBO data from CRBR	UBO data is fetched from the CRBR registry. This may occasionally be slower than direct API calls.

​Start here

Poland coverage, pricing, and sources

​Data Sources

​KRS companies (legal entities)

​CEIDG sole proprietors (individual businesses)

​Entities in neither register

​VAT validation

​Company Identifiers

​Query Identifiers

​Identifiers in API Response

​Legal Entity Identifier (LEI)

​Search Capabilities

​Active companies only

​Company Status

​KRS Companies (primary path)

​CEIDG Sole Proprietors

​Closure Date Priority

​Legal Forms

​Core commercial forms

​Cooperatives and mutuals

​State and public-sector entities

​Associations and foundations

​Trade unions and employer associations

​Guilds, chambers, and business organizations

​Agricultural and transport associations

​Sports bodies

​Public-benefit organizations and church entities

​Foreign branches (KRS)

​Sole traders (CEIDG)

​Entities registered only in REGON

​Legal Representatives

​KRS Management Board Roles

​PESEL, Birth Date and Gender

​Other Key Persons

​Shareholders

​Limitations

​Ultimate Beneficial Owners

​Activity Code Mapping

​Activity Codes by Source

​Data Availability Matrix

​Documents by Company Type

​KRS Companies (prefix: krs-)

​CEIDG Sole Proprietors (prefix: nip-)

​Financial Document Types

​Example API Responses

​Quirks & Gotchas

Start here

Data Sources

KRS companies (legal entities)

CEIDG sole proprietors (individual businesses)

Entities in neither register

VAT validation

Company Identifiers

Query Identifiers

Identifiers in API Response

Legal Entity Identifier (LEI)

Search Capabilities

Active companies only

Company Status

KRS Companies (primary path)

CEIDG Sole Proprietors

Closure Date Priority

Legal Forms

Core commercial forms

Cooperatives and mutuals

State and public-sector entities

Associations and foundations

Trade unions and employer associations

Guilds, chambers, and business organizations

Agricultural and transport associations

Sports bodies

Public-benefit organizations and church entities

Foreign branches (KRS)

Sole traders (CEIDG)

Entities registered only in REGON

Legal Representatives

KRS Management Board Roles

PESEL, Birth Date and Gender

Other Key Persons

Shareholders

Limitations

Ultimate Beneficial Owners

Activity Code Mapping

Activity Codes by Source

Data Availability Matrix

Documents by Company Type

KRS Companies (prefix: `krs-`)

CEIDG Sole Proprietors (prefix: `nip-`)

Financial Document Types

Example API Responses

Quirks & Gotchas