# Poland KRS Company Register Scraper (`scrapers_lat/poland-krs-companies-scraper`) Actor
Look up any Polish company in the KRS National Court Register and export its official extract: KRS, REGON and NIP numbers, legal form, registered address, board members and their roles, proxies, partners and shareholders, share capital and PKD activity codes. Export to JSON, CSV or Excel.
- **URL**: https://apify.com/scrapers\_lat/poland-krs-companies-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Lead generation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $12.75 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Poland KRS Company Register Scraper
> Look up any Polish company in the KRS National Court Register and export a clean, structured extract: KRS, REGON and NIP numbers, legal form, registered address, board members and their roles, proxies, partners and shareholders, share capital and PKD activity codes. Perfect for KYB, due diligence, lead generation and enrichment.
Company identity KRS, REGON, NIP
People board, proxies, partners
JSON / CSV / Excel output formats
**๐ฅ [Input](https://apify.com/scrapers_lat/poland-krs-companies-scraper/input-schema) ยท ๐ค [Output](https://apify.com/scrapers_lat/poland-krs-companies-scraper/output-schema) ยท ๐ฐ [Pricing](https://apify.com/scrapers_lat/poland-krs-companies-scraper/pricing) ยท โถ๏ธ [Examples](https://apify.com/scrapers_lat/poland-krs-companies-scraper/examples)**
### What you get
Each record is one company extract, ready for a CRM, a due-diligence file or a spreadsheet:
- **krsNumber**, **register**: the KRS number and which register it sits in
- **name**, **legalForm**: the registered name and legal form
- **regon**, **nip**: national statistical and tax identifiers
- **status**, **registrationDate**, **asOfDate**: extract type and dates
- **address**, **street**, **postalCode**, **city**, **voivodeship**, **county**, **commune**, **country**: the registered seat
- **shareCapital**: value and currency of the share capital
- **representationRule**, **representationBody**: how the company is represented
- **officers**: board members with **name** and **role** (for example president of the board)
- **proxies**: registered proxies (prokurenci) with proxy type
- **partners**: partners or shareholders with names, shares held and identifiers
- **mainActivity** and **otherActivities**: PKD business activity codes and descriptions
- **isPublicBenefit**: public benefit organisation status
- **observedAt**: when the extract was read
### Who is it for
| Use case | Who benefits |
|---|---|
| KYB and compliance | Teams verifying Polish counterparties, officers and ownership |
| Due diligence | Analysts checking legal form, capital and board before a deal |
| Lead generation | Sales teams enriching Polish companies with firmographics |
| Data enrichment | Builders adding official identifiers (REGON, NIP) to their records |
### How to use it
1. Enter a **KRS number** (10 digits, with or without leading zeros, for example `0000006646`).
2. To look up many companies at once, add a list under **KRS numbers (bulk)**.
3. Set **Max Items** and run. Export as JSON, CSV or Excel, or pull it through the Apify API.
### Frequently Asked Questions
**What is a KRS number?**
The KRS number is the unique registration number assigned to a company, association or foundation in Poland's National Court Register. It has 10 digits; this scraper accepts it with or without leading zeros.
**Do I get the board members and shareholders?**
Yes. Each extract includes the officers with their roles, any registered proxies, and the partners or shareholders together with the share capital, where the register lists them.
**Can I look up several companies in one run?**
Yes. Use the bulk KRS numbers field to pass a list, and set Max Items to control how many are collected.
**What if a number is not found?**
If a KRS number has no public extract, the record for that number carries a short note so you can see which lookups matched and which did not.
**How fresh is the data?**
Each extract is read live at run time and reflects the current public register entry (see observedAt and asOfDate).
### Example use cases
Ready-to-run example tasks, each preconfigured for a common scenario. Open one and press run, or use it as a template:
- [Polish company KRS lookup (batch 1)](https://apify.com/scrapers_lat/poland-krs-companies-scraper/examples/plkrs-krs-lookup-1): Look up Polish companies in the KRS court register by number: name, REGON, NIP, board members, share capital and PKD activity.
- [Polish company KRS lookup (batch 2)](https://apify.com/scrapers_lat/poland-krs-companies-scraper/examples/plkrs-krs-lookup-2): Look up Polish companies in the KRS court register by number: name, REGON, NIP, board members, share capital and PKD activity.
- [Polish company KRS lookup (batch 3)](https://apify.com/scrapers_lat/poland-krs-companies-scraper/examples/plkrs-krs-lookup-3): Look up Polish companies in the KRS court register by number: name, REGON, NIP, board members, share capital and PKD activity.
- [Polish company KRS lookup (batch 4)](https://apify.com/scrapers_lat/poland-krs-companies-scraper/examples/plkrs-krs-lookup-4): Look up Polish companies in the KRS court register by number: name, REGON, NIP, board members, share capital and PKD activity.
- [Polish company KRS lookup (batch 5)](https://apify.com/scrapers_lat/poland-krs-companies-scraper/examples/plkrs-krs-lookup-5): Look up Polish companies in the KRS court register by number: name, REGON, NIP, board members, share capital and PKD activity.
- [Polish company KRS lookup (batch 6)](https://apify.com/scrapers_lat/poland-krs-companies-scraper/examples/plkrs-krs-lookup-6): Look up Polish companies in the KRS court register by number: name, REGON, NIP, board members, share capital and PKD activity.
- [Polish company KRS lookup (batch 7)](https://apify.com/scrapers_lat/poland-krs-companies-scraper/examples/plkrs-krs-lookup-7): Look up Polish companies in the KRS court register by number: name, REGON, NIP, board members, share capital and PKD activity.
- [Polish company KRS lookup (batch 8)](https://apify.com/scrapers_lat/poland-krs-companies-scraper/examples/plkrs-krs-lookup-8): Look up Polish companies in the KRS court register by number: name, REGON, NIP, board members, share capital and PKD activity.
- [Polish company KRS lookup (batch 9)](https://apify.com/scrapers_lat/poland-krs-companies-scraper/examples/plkrs-krs-lookup-9): Look up Polish companies in the KRS court register by number: name, REGON, NIP, board members, share capital and PKD activity.
- [Polish company KRS lookup (batch 10)](https://apify.com/scrapers_lat/poland-krs-companies-scraper/examples/plkrs-krs-lookup-10): Look up Polish companies in the KRS court register by number: name, REGON, NIP, board members, share capital and PKD activity.
### Related scrapers
- [UK Companies House Scraper](https://apify.com/scrapers_lat/uk-companies-house-scraper)
- [OpenCorporates Company Scraper](https://apify.com/scrapers_lat/opencorporates-scraper)
- [Company Verification Scraper](https://apify.com/scrapers_lat/company-verification-scraper)
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for public platforms: finance, news, real estate, jobs, e-commerce and government data. Browse the full catalog or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with the Polish Ministry of Justice or the National Court Register. It only accesses publicly available company data. Use the results in accordance with the source's terms.
# Actor input Schema
## `maxCompanies` (type: `integer`):
Maximum number of Polish KRS companies to collect. Optional.
## `krsNumber` (type: `string`):
A single Polish KRS number to look up. 10 digits, with or without leading zeros (for example 0000006646 or 6646).
## `krsNumbers` (type: `array`):
Optional. A list of KRS numbers to look up in one run. Each is 10 digits, with or without leading zeros.
## Actor input object example
```json
{
"maxCompanies": 30,
"krsNumber": "0000006646",
"krsNumbers": [
"0000006646",
"0000489679"
]
}
````
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxCompanies": 30,
"krsNumber": "0000006646",
"krsNumbers": [
"0000006646",
"0000489679"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/poland-krs-companies-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`๐พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxCompanies": 30,
"krsNumber": "0000006646",
"krsNumbers": [
"0000006646",
"0000489679",
],
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/poland-krs-companies-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("๐พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxCompanies": 30,
"krsNumber": "0000006646",
"krsNumbers": [
"0000006646",
"0000489679"
]
}' |
apify call scrapers_lat/poland-krs-companies-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/poland-krs-companies-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Poland KRS Company Register Scraper",
"description": "Look up any Polish company in the KRS National Court Register and export its official extract: KRS, REGON and NIP numbers, legal form, registered address, board members and their roles, proxies, partners and shareholders, share capital and PKD activity codes. Export to JSON, CSV or Excel.",
"version": "0.1",
"x-build-id": "wAKbU53zrVfPXntLg"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~poland-krs-companies-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-poland-krs-companies-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapers_lat~poland-krs-companies-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-poland-krs-companies-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapers_lat~poland-krs-companies-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-poland-krs-companies-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"maxCompanies": {
"title": "Max Companies",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of Polish KRS companies to collect. Optional."
},
"krsNumber": {
"title": "KRS number",
"type": "string",
"description": "A single Polish KRS number to look up. 10 digits, with or without leading zeros (for example 0000006646 or 6646)."
},
"krsNumbers": {
"title": "KRS numbers (bulk)",
"type": "array",
"description": "Optional. A list of KRS numbers to look up in one run. Each is 10 digits, with or without leading zeros.",
"items": {
"type": "string"
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```