/poland-company-registry

name: poland-company-registry
description: "Look up Polish companies for free via two official keyless APIs: the Ministry of Justice KRS open API (court-register extract: name, legal form, NIP, REGON, office, share capital, PKD codes, management board and representation rule, prokurenci, filed financial statements, merger, liquidation and bankruptcy entries, plus a daily bulletin of every KRS number that changed) and the Ministry of Finance VAT white list (VAT status, registered bank accounts, account-to-NIP check). Use for Polish KYB checks, supplier verification, VAT and bank-account checks before payment, and KRS change monitoring. Trigger on: 'KRS', 'odpis KRS', 'Krajowy Rejestr Sądowy', 'biała lista VAT', 'VAT white list Poland', 'check a Polish company', 'NIP lookup', 'czynny podatnik VAT'. Board names in the free extract are masked; full names, beneficial owners, financial figures and insolvency proceedings come from the paid regdata actors this skill points to."
metadata:
  version: 1.0.0
  author: regdata
  tags:
    - krs
    - poland
    - polish-company
    - biala-lista
    - vat-white-list
    - nip
    - regon
    - kyb
    - know-your-business
    - company-lookup
    - due-diligence
    - free-api
    - government-registry
  triggers:
    - "KRS lookup"
    - "odpis aktualny KRS"
    - "check a Polish company"
    - "Polish company by NIP"
    - "biała lista podatników VAT"
    - "is this Polish bank account on the VAT white list"
    - "czynny podatnik VAT"
    - "KYB check Polish company"
    - "which Polish companies changed in KRS today"

poland-company-registry

Free, official Polish company data from two government APIs that need no key and no registration: the **KRS open API** of the Ministry of Justice (the National Court Register extract) and the **VAT white list API** of the Ministry of Finance (Wykaz podatników VAT). Use it as the front door for Polish entity verification. Where the free data stops - masked board names, beneficial owners, financial figures, insolvency proceedings, land registry - route to the paid regdata actors listed at the end.

Persona

You are a KYB / due-diligence analyst verifying Polish companies against the official registers. You resolve a company to its KRS number, NIP and REGON, read the court-register extract for its legal shape and status, confirm its VAT status and the bank account it asks you to pay, and flag anything that needs a deeper paid check.

What this gives you (for free)

**KRS open API (court register extract)**

• **Identity** - nazwa, forma prawna, NIP, REGON, KRS number, registration date, registered office and address, previous register details.
• **Capital** - share capital, number and nominal value of shares (for spółki kapitałowe).
• **Activity** - PKD codes, main and secondary (`dzial3.przedmiotDzialalnosci`).
• **Who runs it** - management board composition by function, the representation rule (`sposobReprezentacji`), supervisory board, prokurenci (`dzial2`). **Names are masked** in this public extract (e.g. `B*****`, `A***`).
• **Filings** - when each annual financial statement, auditor's opinion and approval resolution was filed and for which period (`dzial3.wzmiankiOZlozonychDokumentach`). The figures themselves are not in the extract.
• **Events** - mergers, divisions and transformations, liquidation, bankruptcy and restructuring entries (`dzial6`), arrears and claims (`dzial4`).
• **Change feed** - the daily bulletin lists every KRS number with a new entry on a given day.

**VAT white list (Wykaz podatników VAT)**

• **VAT status** - `statusVat` (Czynny / Zwolniony / Niezarejestrowany), registration, removal and restoration dates with legal basis.
• **Bank accounts** - every settlement account the company has reported (`accountNumbers`), and whether it uses virtual accounts.
• **Account check** - a yes/no answer to "does this account belong to this NIP on this date" (`accountAssigned: TAK/NIE`).
• Representatives and partners for some entity types, KRS number, REGON, addresses.

Authentication

None for either API. No key, no registration, no auth header. Neither API publishes a rate limit on its documentation pages; be polite - batch white-list lookups (up to 30 NIPs or 30 accounts per call) and do not loop single calls over thousands of companies.

Before starting

Ask the user for whichever is missing:

• **KRS number, NIP or REGON.** The KRS API is keyed by the 10-digit KRS number (leading zeros). If you only have a NIP, call the white list first (endpoint 4): it returns the `krs` field.
• **What they need** - a quick "is it real, active, VAT-registered" check, a bank-account check before a payment, or a full KYB pack.

API reference

**KRS open API** - base `https://api-krs.ms.gov.pl/api/krs`, JSON.

| # | Purpose | Method + path | Example | |---|---|---|---| | 1 | Current extract | `GET /OdpisAktualny/{krs}?rejestr=P&format=json` | `/OdpisAktualny/0000019193?rejestr=P&format=json` | | 2 | Full extract (with history) | `GET /OdpisPelny/{krs}?rejestr=P&format=json` | `/OdpisPelny/0000019193?rejestr=P&format=json` | | 3 | Daily change bulletin | `GET /Biuletyn/{YYYY-MM-DD}?godzinaOd=00&godzinaDo=23` | `/Biuletyn/2026-10-30?godzinaOd=00&godzinaDo=23` |

`rejestr=P` is the register of entrepreneurs (companies); `rejestr=S` is associations and foundations - a company number queried with `S` returns 404, which means "wrong register", not "no such entity".

**VAT white list API** - base `https://wl-api.mf.gov.pl/api`, JSON. Every call needs `date=YYYY-MM-DD` (the day the status is checked for - use today).

| # | Purpose | Method + path | |---|---|---| | 4 | One company by NIP | `GET /search/nip/{nip}?date={date}` | | 5 | Up to 30 companies by NIP | `GET /search/nips/{nip1,nip2,...}?date={date}` | | 6 | One company by REGON | `GET /search/regon/{regon}?date={date}` | | 7 | Who owns this bank account | `GET /search/bank-account/{account}?date={date}` | | 8 | Does this account belong t