Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (n8n-nodes-biala-lista-vat) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
n8n-nodes-biala-lista-vat
n8n community node for Biala Lista VAT (White List of VAT Taxpayers) -- verify Polish VAT taxpayers and bank accounts via the official Ministry of Finance API.
This is a public API that requires no credentials or registration.
Operations
Subject (Search)
| Operation | Description |
|---|---|
| Search by NIP | Search VAT taxpayer by NIP number |
| Search by NIPs (Batch) | Batch search up to 30 NIP numbers |
| Search by REGON | Search VAT taxpayer by REGON number |
| Search by REGONs (Batch) | Batch search up to 30 REGON numbers |
| Search by Bank Account | Find VAT taxpayer by bank account number |
| Search by Bank Accounts (Batch) | Batch search up to 30 bank account numbers |
Verification (Check)
| Operation | Description |
|---|---|
| Check NIP + Bank Account | Verify if a bank account belongs to a NIP holder |
| Check REGON + Bank Account | Verify if a bank account belongs to a REGON holder |
Important Notes
Date Parameter
The date parameter is required on every request (format: YYYY-MM-DD). The API returns the taxpayer status as of the specified date.
Bank Account Format
Bank account numbers must be in NRB format -- 26 digits, no spaces, no dashes.
Example: 12345678901234567890123456
Batch Operations
Batch operations accept a maximum of 30 comma-separated values (no spaces between values).
Example: 5213017228,1234567890,9876543210
VAT Status Values
The statusVat field in responses can have the following values:
| Value | Meaning |
|---|---|
Czynny |
Active VAT taxpayer |
Zwolniony |
Exempt from VAT |
Niezarejestrowany |
Not registered for VAT |
Rate Limits
The API enforces daily rate limits (reset at 00:00 CET):
| Endpoint Type | Daily Limit |
|---|---|
Search (/api/search/...) |
10 requests/day |
Check (/api/check/...) |
5,000 requests/day |
Use batch operations to maximize efficiency within the search limit.
Installation
In n8n (Community Nodes)
- Go to Settings > Community Nodes
- Select Install
- Enter
n8n-nodes-biala-lista-vat - Agree to the risks and click Install
Manual Installation
cd ~/.n8n/custom
npm install n8n-nodes-biala-lista-vatThen restart n8n.