verify-polish-company

Verify a Polish company (skanfirmy.pl)

This skill verifies Polish businesses straight from official government registers (Ministry of Finance, Ministry of Justice / KRS, Statistics Poland / GUS, and the European Commission / VIES) through skanfirmy.pl, a free public API. Every endpoint is a plain GET that returns JSON when you add ?format=json. No API key, no account. The service is meant for single, user-driven lookups, not bulk data harvesting: REST allows at most 20 requests per 10 seconds from one IP address (HTTP 429 for 10 seconds above that), the MCP server 60 per 10 seconds.

Sole traders and other natural persons (JDG, civil partnerships) get minimised data (GDPR): name, NIP, VAT status, town and the number of White List accounts — no REGON, no address, no registration date, no PKD and no list of account numbers. To check one specific account of such a counterparty, use POST /rachunek (or the MCP tool sprawdz_rachunek). Companies (entities with a KRS number) get full data.

When to use it

Reach for this skill when the user asks to:

• check whether a Polish company is an active VAT payer or is VAT-exempt;
• verify that a bank account belongs to a contractor on the White List (needed for Polish "due diligence" on payments over 15 000 PLN);
• pull a company's KRS registry data (legal form, PKD, share capital, address, representation) by NIP or KRS number;
• look up REGON and official name/address of a company by NIP (for sole traders only the name, legal form, town and activity status);
• validate an EU VAT number (any member state) via VIES;
• check many NIPs at once.

NIP = 10-digit Polish tax ID. KRS = court-register number. REGON = statistical register number. VAT-UE/VIES numbers are prefixed by a 2-letter country code (e.g. DE, IE, FR).

REST endpoints (GET, keyless)

Call these with any HTTP client (curl, fetch, requests, a web-fetch tool). Append ?format=json for machine-readable JSON; without it you get crawlable HTML with embedded JSON-LD.