Poland KRS Company Registry Scraper

What this Actor scrapes

The Polish Ministry of Justice publishes KRS company records through a free, keyless JSON API (api-krs.ms.gov.pl), but each response is a ~50 KB envelope nesting identity, address, representatives, PKD codes and share capital three or four levels deep — exactly the kind of raw government JSON that KYC/AML analysts and B2B lead-gen teams currently have to hand-parse themselves. No visible rival on the Apify Store currently holds a KRS-register listing. This Actor takes a batch of KRS numbers, flattens each one into a single typed row, and lets you pick exactly which sections you need so you never pay transfer for data you didn't ask for.

What we handle for you

• 🧊 Flattens a ~50 KB nested JSON envelope into one clean row — identity, address, representatives, PKD codes, capital and status, picked via a Sections filter so you only pay transfer for what you need.
• 🔢 KRS numbers stay strings, always — leading zeros never get stripped by a spreadsheet export or an overeager number cast.
• 🔁 Retries transient 429/5xx responses with exponential backoff, honouring Retry-After when the Ministry's API sends one.
• 🩹 Per-item and per-section fault isolation — one bad KRS number or one missing sub-key logs a warning and moves on; it never crashes the run.
• 🧱 Honest not-found handling — an unknown KRS number still finishes SUCCEEDED with found: false and a warning, never a crashed run.
• 💰 Pay-Per-Event pricing — a delivered answer (found or not) still costs you $0.01; invalid input costs nothing.

Use cases

• Run a KYC/AML check on a Polish counterparty by KRS number before onboarding.
• Build a Polish B2B prospect list from a batch of KRS registration numbers.
• Verify legal representatives and share capital for a due-diligence file.
• Screen a supplier or partner list for companies in liquidation or deleted from the register.

Input

Paste this into the Apify Console, or send it as the run input over the API. Proxy settings are on by default; you rarely need to touch them.

{
  "krsNumbers": [
    "0000006865",
    "6865",
    "9999999999"
  ],
  "registryType": "P",
  "sections": [
    "identity",
    "address",
    "representatives",
    "pkd",
    "capital",
    "status"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Output

One row per result, schema-validated before it is written. Export JSON, CSV, Excel or XML from the run, or read it over the API.

krs_numberregistry_typefoundnamelegal_formnipregonstatus

{
  "krs_number": "0000006865",
  "registry_type": "P",
  "found": true,
  "warning": null,
  "name": "EXAMPLE SP\u00d3\u0141KA Z OGRANICZON\u0104 ODPOWIEDZIALNO\u015aCI\u0104",
  "legal_form": "SP\u00d3\u0141KA Z OGRANICZON\u0104 ODPOWIEDZIALNO\u015aCI\u0104",
  "nip": "5252445876",
  "regon": "015691077",
  "registration_date": "2001-07-25",
  "address_street": "ul. Przyk\u0142adowa 1",
  "address_city": "Warszawa",
  "address_postal_code": "00-001",
  "address_country": "Polska",
  "representatives": [
    {
      "name": "Jan Kowalski",
      "role": "Prezes Zarz\u0105du"
    }
  ],
  "pkd_codes": [
    {
      "code": "62.01.Z",
      "description": "Dzia\u0142alno\u015b\u0107 zwi\u0105zana z oprogramowaniem",
      "is_primary": true
    }
  ],
  "share_capital_amount": "50000.00",
  "share_capital_currency": "PLN",
  "status": "active",
  "source_url": "https://api-krs.ms.gov.pl/api/krs/OdpisAktualny/0000006865?rejestr=P&format=json",
  "scraped_at": "2026-09-06T12:00:00+00:00"
}

Pricing

You pay only for results that land. Cap any run with maxTotalChargeUsd. See pricing & billing for worked examples.

Limitations

• No keyless name/NIP/REGON search — v1 takes a list of KRS numbers only; the Ministry's public API has no such search endpoint.
• Only OdpisAktualny (current-state extract) is queried — historical change history (OdpisPelny) is out of scope for v1.
• rejestr=S (associations) may have minor structural differences from rejestr=P; any section that fails to parse degrades to a warning rather than crashing the row.