Poland KRS Company Profile and Change Watchlist

What it does

Fetch business-only profiles for supplied KRS company numbers from the official Polish Ministry of Justice public API. Export registered names, legal forms, NIP/REGON identifiers, registered addresses and listed activity codes. Compare the business fields with profiles you previously exported, producing a reviewable difference report for B2B company checks, CRM data maintenance or procurement watchlists.

This is not the offline identifier validator, a search across all companies, a new-company discovery feed, or a source of private contacts. It queries only the supplied identifiers in commercial register P. Board, shareholder, natural-person, email/contact and financial-statement fields are not projected into reports.

Input

krsNumbers contains1to20 distinct ten-digit strings. Numbers are not accepted as JSON numbers because leading zeros matter. previousProfiles optionally accepts the complete profiles array from a prior report, with projectionVersion1 and the same business fields. A supplied fingerprint is recomputed and checked. Unknown extra baseline fields are not copied into output. Baselines remain customer-supplied, not independently verified historical records.

pkdPrefixes optionally matches source-listed activity code prefixes, for example41,42,43 for section-level checks. Codes are kept at the granularity returned by the source; partial group codes are not padded into invented full codes. Missing or incomplete activity coverage yields unknown when no match can be established. This is not a taxonomy mapping between PKD editions or verification of actual commercial activity.

maxCompanies and maxRequests cap the work at20. The total input cap is2MB, a source response is capped at1MB, and the report at7MB. The official source origin and endpoint are fixed; arbitrary URLs, credentials and proxies are not accepted. Redirects are rejected before another destination is contacted. Requests are sequential, with at least one second between starts, a15second timeout and zero retries. Missing or unsupported source shapes are not accepted as an empty successful profile.

Output

One dataset report contains verified profiles, supplied-baseline comparisons, activity match observations and explicit source failures. AUDIT is complete JSON, PROFILES_CSV is a spreadsheet-safe company overview and REPORT is Markdown. Feed report.profiles into previousProfiles in a later run to compare snapshots. The Actor does not install a schedule, fetch hidden history, send alerts to third parties or overwrite your baselines.

Source fields are normalized into a stable business projection. Dates from registry headers are preserved as source text; fetchedAt is the actual retrieval timestamp and is not the registry update time. Volatile retrieval timestamps do not affect business fingerprints. A registry revision can change while the selected business fields remain identical; this is reported separately because excluded fields may have changed.

BUSINESS_FIELDS_DIFFER means only that selected fields differ from the supplied baseline. It does not independently establish a real historical change, its legal effective time or the direction of a transaction. Nulls represent unavailable coverage. NO_BASELINE is unknown history, not proof that a company is newly registered or unchanged.

Pricing and cost control

Launch price: USD0.03 per completed company-watchlist-report for up to20 requested identifiers. Check the current Store price before running. Cost estimates in PRICING are planning values. A partial report with at least one verified profile is emitted once and lists all failures. If every source lookup fails, SOURCE_STATUS is saved and the run fails without a report event; platform execution costs can still apply under the platform terms.

HTTP404 means not found through this register-P lookup, not proof that the entity does not exist elsewhere. Access denial, rate limit, server/transport error, unexpected identity or bad JSON stops further lookups for that run; remaining identifiers are marked skipped. The Actor never switches sources, accounts or proxies to bypass a refusal. It uses no paid model or upstream API subscription.

Limitations and fair use

A current extract does not certify active trading, solvency, tax status, ownership, creditworthiness or a compliance decision. This tool does not fetch association register S, VIES/VAT status, beneficial owners, financial accounts, phone numbers or people profiles. Source availability and schema can change; source failures remain explicit. Use the official source for legal interpretation and final verification.

Only minimized corporate fields are exported. Raw government responses are not saved by the handler, and people/contact sections are excluded. Input and output still use Apify run storage under its retention settings; use only authorized baselines and avoid personal or secret data. Registered company names and addresses can themselves contain names, so this projection is not an anonymization service.

Example

examples/input.json queries the public ORLEN KRS number0000028860 with no baseline. A successful first run has NO_BASELINE and does not claim a historical change. Unit fixtures use explicitly synthetic companies. Run npm ci --ignore-scripts, npm test, then the existing factory release.mjs --local-run --write-example. Source remains in this existing factory; Apifi boty is a generated view, not a second codebase.

Source

Official endpoint pattern: https://api-krs.ms.gov.pl/api/krs/OdpisAktualny/0000028860?rejestr=P&format=json . No official endorsement is claimed.