Poland Supplier Risk & VAT Registry Checker

Verify a Polish company or supplier against official public registers in a single run.

The Actor checks identity data across the Polish National Court Register (KRS) and the Ministry of Finance VAT Whitelist, then returns a structured JSON report with clear verification signals and source evidence.

What this Actor checks

• current VAT status
• NIP, REGON, and KRS consistency across supplied input and official sources
• company name and addresses
• legal form and registration details from KRS
• date of the latest KRS entry
• representation method and available representative records
• optional bank-account assignment in the VAT Whitelist for a selected date
• official request IDs and source-level errors for audit and troubleshooting

Common use cases

• supplier and contractor onboarding
• vendor master-data validation
• procurement due diligence
• payment pre-checks
• counterparty verification workflows
• API-based company-data enrichment

Input

Provide at least one Polish company identifier:

• nip — 10 digits
• krs — up to 10 digits; leading zeros are added automatically
• regon — 9 or 14 digits

Optional fields:

• bankAccount — Polish account number or IBAN; spaces and the PL prefix are accepted
• checkDate — verification date in YYYY-MM-DD format; defaults to today
• language — en or pl for the summary
• includeRawData — include full official API responses in the output

Bank-account verification requires nip or regon in the same run.

Example input

{
  "nip": "5252674798",
  "krs": "0000635012",
  "regon": "365331553",
  "language": "en",
  "includeRawData": false
}

Output

Each successful run writes one report to the default dataset and stores the same report as OUTPUT in the default key-value store.

Main fields:

• verificationStatus
• summary
• checkedAtDate
• input
• company
• bankAccountVerification
• riskSignals
• evidence
• disclaimer

Verification statuses

• verified — no material warning signal was detected in the checked fields
• manual_review — official data was missing, incomplete, or ambiguous
• high_attention — a material mismatch or adverse registry signal was detected

Example result

{
  "verificationStatus": "verified",
  "summary": "ALLEGRO SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ: verification completed without material warning signals. High-severity signals: 0; medium-severity signals: 0.",
  "company": {
    "name": "ALLEGRO SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ",
    "nip": "5252674798",
    "regon": "365331553",
    "krs": "0000635012",
    "vatStatus": "Czynny"
  },
  "riskSignals": [
    {
      "severity": "info",
      "code": "VAT_ACTIVE",
      "message": "Entity is shown as an active VAT taxpayer."
    },
    {
      "severity": "info",
      "code": "KRS_FOUND",
      "message": "A current KRS extract was returned."
    }
  ]
}

Risk signals

The Actor uses deterministic rules rather than an opaque score. Examples include:

• VAT_ACTIVE
• VAT_STATUS_ALERT
• VAT_ENTITY_NOT_FOUND
• KRS_FOUND
• KRS_NOT_FOUND
• NIP_MISMATCH
• REGON_MISMATCH
• KRS_MISMATCH
• BANK_ACCOUNT_MATCH
• BANK_ACCOUNT_MISMATCH
• BANK_ACCOUNT_UNVERIFIED

Every signal includes a severity, code, and readable message.

Official data sources

• Polish Ministry of Justice — National Court Register current extract API
• Polish Ministry of Finance — VAT Whitelist API

No external API key is required.

Important limitations

This Actor provides automated public-registry verification signals. It is not a credit score and does not replace legal, tax, accounting, AML, sanctions, or procurement review.

KRS details are available only for entities registered in KRS. Sole traders or other entities outside KRS may return partial company information. Results also depend on the availability and freshness of the official source systems at the time of the run.

Review the official source records before making consequential decisions.