io.github.bartosz-kuc/skanfirmy

Tools

• changes_since

  Return changes (VAT status, bank accounts, or registry data — name, address, KRS, REGON — from the White List) detected since a given date for the NIPs you monitor. The field property is one of: status_vat, account_added, account_removed, name, address, krs, regon. A polling channel for agents. Requires a skanfirmy API key.

  shallow
• generuj_mikrorachunek

  Generate the individual tax micro-account (for PIT/CIT/VAT payments) from a NIP or PESEL.

  shallow
• list_observations

  Return the list of NIPs you monitor, with their current VAT status and last-checked date. Each entry keeps the raw Ministry of Finance literal in status_vat and, when a status is known, adds derived language-neutral fields vat_active (boolean) and status_vat_code (active/exempt/not_registered). Requires a skanfirmy API key.

  shallow
• oblicz_odsetki

  Calculate statutory or commercial (B2B) late-payment interest, broken down by NBP reference-rate periods.

  shallow
• observe_nip

  Add a NIP to monitoring. You get notified (via changes_since or email) when its VAT status, bank account, or registry data shown on the Ministry of Finance White List (name, address, KRS, REGON) changes. Requires a skanfirmy API key (Authorization: Bearer, or the api_key argument). Free plan: up to 10 NIPs.

  shallow
• set_webhook

  Set (or clear) a push webhook URL for your monitoring, instead of or in addition to polling. When we detect a change for a monitored NIP, we send a POST signed with HMAC-SHA256 (X-Skanfirmy-Signature header). Returns the secret ONCE. Pass an empty url to disable. Requires a skanfirmy API key. Public https addresses only (port 443).

  shallow
• sprawdz_lista_nip

  Bulk-check up to 30 NIPs in one call to the Ministry of Finance VAT White List: VAT status, bank accounts, REGON, KRS and address of each entity. For verifying a portfolio of counterparties. Ministry limits: max 30 NIPs per call, about 500 bulk queries/day per IP. Does not fetch full KRS data (use sprawdz_nip for individual entities).

  shallow
• sprawdz_nip

  Check VAT status (VAT White List / Biała Lista) and KRS data for a Polish company by NIP.

  shallow
• sprawdz_rachunek

  Check whether a bank account number (NRB) appears in the VAT White List for a given NIP. Due diligence for payments above PLN 15,000.

  shallow
• sprawdz_regon

  Look up entity data in the REGON register (Statistics Poland / GUS BIR) by NIP: REGON number, official name, legal form (legal or natural person), full address (voivodeship, county, municipality). Covers ALL entities, including sole proprietors that are not in the KRS.

  shallow
• sprawdz_vies

  Validate a counterparty's EU VAT number in the VIES system (European Commission).

  shallow
• szukaj_katalog_api

  Search otwarteAPI.pl, a catalog of public Polish and EU APIs (VAT, KRS, GUS, NBP, ECB, Eurostat and more). Returns matching entries with a link to each API's official docs. An empty query returns the whole catalog (optionally narrowed by scope or topic).

  shallow
• szukaj_pkd

  Search PKD 2025 business activity codes by activity name or code number.

  shallow
• unobserve_nip

  Remove a NIP from monitoring. Requires a skanfirmy API key.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/8889fad2-6571-4ace-951f-d2b0235cd366/badge.svg)](https://vouch.tools/servers/8889fad2-6571-4ace-951f-d2b0235cd366)