Polish VAT Whitelist & Pay-Safe Check

What does Polish VAT Whitelist & Pay-Safe Check do?

Verify a Polish company's VAT status or confirm that a NIP and business bank account match in the official Ministry of Finance registry.

• Receive the official VAT status, confirmation ID, and response timestamp.
• Check a NIP–bank account pair without exposing the full account number in results or logs.
• Process small, bounded batches through a simple JSON API—no login, browser, or scraping of HTML pages.

Why use it?

Use this Actor to reduce payment fraud and automate counterparty checks in accounting, invoicing, procurement, and compliance workflows. It is useful for:

• validating a contractor before a first payment;
• checking whether a supplier is an active VAT taxpayer;
• adding an official confirmation ID to an audit trail;
• running recurring pay-safe checks in Make, Zapier, n8n, or your own system.

The Actor uses the official Ministry of Finance API and supports Apify scheduling, dataset exports, API access, and MCP.

What data can you get?

Field	Description
mode	status or paySafe
nip	Checked tax identification number
found	Whether the NIP exists in the registry
statusVat	VAT status returned by the ministry
accountAssigned	Whether the NIP and bank account match
bankAccountLast4	Last four digits of the checked account
requestId	Official electronic confirmation identifier
requestDateTime	Response timestamp from the ministry
date	Verification date
sourceUrl	API endpoint or endpoint group
fetchedAt	Extraction timestamp

The Actor intentionally excludes names, addresses, representatives, partners, full account numbers, and account lists.

Example output

VAT status:

{
    "mode": "status",
    "nip": "5272677009",
    "requestId": "Zq6Pg-99504e4",
    "requestDateTime": "29-10-2026 06:32:04",
    "date": "2026-10-28",
    "sourceUrl": "https://wykazpodatnikowvat.mf.gov.pl/api/search/nip/5272677009?date=2026-10-28",
    "fetchedAt": "2026-10-29T05:32:04.635Z",
    "found": true,
    "statusVat": "Czynny",
    "accountAssigned": null,
    "bankAccountLast4": null
}

Pay-safe check:

{
    "mode": "paySafe",
    "nip": "5272677009",
    "requestId": "TTCKj-99504ai",
    "requestDateTime": "29-10-2026 06:30:42",
    "date": "2026-10-28",
    "sourceUrl": "https://wykazpodatnikowvat.mf.gov.pl/api/check",
    "fetchedAt": "2026-10-29T05:30:42.349Z",
    "found": null,
    "statusVat": null,
    "accountAssigned": true,
    "bankAccountLast4": "5745"
}

How much will it cost?

• $5.00 per 1,000 VAT status results (vat-status).
• $15.00 per 1,000 pay-safe checks (pay-safe-check).

Each saved result is charged once. There is no additional Actor-start or dataset-item event, and platform usage is not charged separately to the user. Measured platform usage for one pay-safe check was approximately $0.0002925.

Free n8n workflow: check a supplier before payment

Download the ready-to-import VAT pay-safe workflow. It takes a supplier NIP and bank account, calls this Actor, and returns the official confirmation ID plus a reviewRequired flag for your payment approval flow. The JSON contains no credentials; use n8n Header Auth credentials for your Apify token.

How to run a check

1. Select VAT status or Pay-safe bank account check.
2. Enter one or more 10-digit NIP numbers. Pay-safe mode accepts exactly one NIP.
3. In pay-safe mode, enter the 26-digit business bank account.
4. Optionally choose a historical verification date and start the Actor.
5. Download results as JSON, CSV, or Excel.

A missing company returns found: false; it is not treated as an infrastructure failure.

Input and safeguards

• Maximum results: 10 by default, capped at 100 per run.
• Maximum concurrency: 2 by default.
• Maximum requests per minute: 30 by default.
• Maximum retries: 4 by default for network errors, HTTP 429, and HTTP 5xx.
• Request timeout: 20 seconds by default.

HTTP 404 and other non-retryable 4xx responses fail immediately. Invalid JSON and unexpected response structures count as parsing failures. Every run ends with categorized error counters.

Development and validation

npm install
npm run build
npm test
apify validate-schema
apify run

The bundled local input limits the live smoke run to one result. Unit tests cover active and missing companies, account assignment, invalid structures, retry policy, and silent failures.

Legal, privacy, and support

This Actor uses publicly available business registry data from the official Ministry of Finance API. It does not bypass access controls and respects published API limits. Do not use it to collect personal data.

For bugs or feature requests, use the Issues tab. Programmatic access is available through API and MCP.

Store metadata

• Categories: Finance, Compliance, Business Data, Government and Public Data
• Keywords: Poland VAT, NIP verification, white list VAT, pay safe, bank account verification, contractor validation, Ministry of Finance, KSeF, accounting automation