# Czech Company Data — ARES Registry, VAT & Directors (`foxlabs/czech-company-data`) Actor

Search 3M+ Czech companies from the official ARES registry (ares.gov.cz) — identity, IČO, VAT (DIČ), legal form, NACE, registered address and founding date, plus optional directors/board (names, roles) and share capital. Open data, no key.

- **URL**: https://apify.com/foxlabs/czech-company-data.md
- **Developed by:** [Berkan Kaplan](https://apify.com/foxlabs) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 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.

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.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

<p align="center"><a href="https://apify.com/foxlabs/czech-company-data"><img src="https://data.foxlabs.com.tr/img/czech-company-data-banner.svg" alt="Czech Company Data" width="100%" /></a></p>

## Czech Company Data — ARES Registry, VAT & Directors

Look up **any Czech company** — verified identity, VAT number, what it does, who runs it and how much capital it holds. This Actor reads the Czech Ministry of Finance's official **ARES** registry (Administrativní registr ekonomických subjektů) and returns clean, structured records: legal name, **IČO**, **VAT (DIČ)**, legal form, **NACE** activity codes, registered address and founding date — plus, on demand, the **board of directors** and **share capital** from the public register.

Built on the **official ARES REST API** — **open data, no API key, no login, no scraping**. Search by name, look up exact IČO numbers, and filter by address or active status.

- 🇨🇿 **3M+ Czech entities** — the whole ARES registry
- 🆔 **Identity + VAT (DIČ)** + legal form + NACE codes + address
- 👔 **Directors & capital** *(opt-in)* — statutory body / board (names, roles, tenure), supervisory board and registered share capital
- ✅ **Active filter** — exclude dissolved entities
- 🆓 **Open data** — reuse and redistribute, no key

### Quick start (API)

Look up two companies by IČO with directors and capital:

```bash
curl -X POST "https://api.apify.com/v2/acts/foxlabs~czech-company-data/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "icoList": ["00177041", "27082440"], "includeDirectors": true }'
````

Prefer no code? Open the **Input** tab, enter a name or IČO numbers, and click **Start** — then download the results.

### What you get

One clean, flat record per company:

| Field | Type | Description |
|---|---|---|
| `name` | string | Registered legal name |
| `ico` | string | 8-digit company ID (IČO) |
| `vat` | string | VAT number (DIČ), if VAT-registered |
| `legalForm` / `legalFormCode` | string | Legal form in English + the ARES code |
| `address` / `city` / `region` / `postalCode` | string | Registered seat |
| `nace` / `primaryNace` | array / string | CZ-NACE activity codes |
| `foundingDate` | string | Date of establishment |
| `isActive` / `activeRegisters` | bool / array | Whether it's active, and in which registers |
| `directors` *(opt-in)* | array | Statutory body / board — `{ name, role, from, type, citizenship }` |
| `supervisoryBoard` *(opt-in)* | array | Supervisory board members |
| `capital` *(opt-in)* | object | Registered share capital `{ amount, currency }` |
| `source` / `license` / `aresUrl` | string | Provenance — ARES, open data, and the ARES page |

Missing values come back as `null`, never a guess.

#### Sample output

Real record for **Škoda Auto a.s.** (`icoList: ["00177041"]`, directors on) — board abbreviated:

```json
{
  "name": "Škoda Auto a.s.",
  "ico": "00177041",
  "vat": "CZ00177041",
  "legalForm": "Joint-stock company (a.s.)",
  "legalFormCode": "121",
  "address": "tř. Václava Klementa 869, Mladá Boleslav II, 29301 Mladá Boleslav",
  "city": "Mladá Boleslav",
  "nace": ["70200", "471", "77110"],
  "primaryNace": "70200",
  "foundingDate": "1990-11-20",
  "isActive": true,
  "directors": [
    { "name": "MARTIN JAHN", "role": "člen představenstva", "from": "2024-03-01", "type": "person" }
  ],
  "capital": { "amount": 16708850000, "currency": "CZK" },
  "source": "ARES — Administrative Register of Economic Entities (Czech Republic)",
  "license": "Open data — Ministry of Finance of the Czech Republic",
  "aresUrl": "https://ares.gov.cz/ekonomicke-subjekty?ico=00177041"
}
```

### Example inputs (copy & paste)

```jsonc
// 1) Exact lookup by IČO, with directors & capital
{ "icoList": ["00177041", "27082440"], "includeDirectors": true }

// 2) Name search
{ "searchQuery": "Kaufland", "maxResults": 100 }

// 3) Name + address, active only, with the board
{ "searchQuery": "logistika", "addressQuery": "Praha", "onlyActive": true, "includeDirectors": true }

// 4) Fast identity-only pull
{ "searchQuery": "Alza", "maxResults": 50 }
```

### Input & filters

- **Company name contains** (`searchQuery`) — substring match on the name. ARES caps a single search at **1,000 results** — narrow broad terms with an address or exact IČO (the Actor warns, it won't crash).
- **IČO numbers** (`icoList`) — exact lookup; overrides the name search.
- **Address contains** (`addressQuery`) — filter by registered address (city / street).
- **Only active** (`onlyActive`) — exclude dissolved entities.
- **Include directors & capital** (`includeDirectors`) — attach the board, supervisory board and share capital.
- **Max results** (`maxResults`) — 1 to **100,000**.

### Use cases

- **B2B prospecting & enrichment.** Match your CRM on IČO or name and top up VAT, legal form, NACE and address.
- **KYC / KYB & due diligence.** Verify a Czech counterparty, its directors and its share capital in one call.
- **Board / director mapping.** Attach the statutory body to see who runs a company.
- **Market & competitor research.** Search a name or sector and size the field.

### Performance & throughput

The Actor calls the live ARES API (search returns full records in pages of 100; directors/capital add one public-register lookup per company, 5 in parallel). No proxies, no keys. A single search is bounded to ARES's 1,000-result cap; use IČO lists or narrower filters for large pulls.

### Integrations

Works with **JavaScript / Python `apify-client`**, **Make / n8n / Zapier**, scheduled runs, webhooks, and the **Apify MCP server**.

```js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('foxlabs/czech-company-data').call({ icoList: ['00177041'], includeDirectors: true });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

### Data quality (honest)

- **Identity, legal form, NACE, address and founding date are complete** for essentially every entity — core ARES fields.
- **VAT (DIČ)** is present only for VAT-registered subjects; associations and non-registered entities return `null`.
- **Directors** come from the public register (Veřejný rejstřík), which keeps full history and doesn't always record end dates — the Actor returns members with a start date and no recorded end, **most-recently-appointed first**, so a long-lived company may include a few historical entries. Roles and tenure dates are as filed.
- **Capital** is the latest registered share capital.
- Nothing is fabricated — a missing value is `null`.

### Pricing

**Pay per result** — billed per company returned; directors and capital are included when enabled. Apify **free tier** to evaluate. No proxies, no third-party API costs — ARES is a free public API.

### FAQ

**Where does the data come from?** The Czech Ministry of Finance's official **ARES** registry (ares.gov.cz).

**Can I use it commercially / resell it?** Yes — ARES is open public data.

**Do I get director names?** Yes, with **Include directors & capital** on (statutory body + supervisory board, with roles and tenure).

**Why does a broad search return nothing with a warning?** ARES rejects any single search returning more than 1,000 companies — narrow it (a more specific name, an address, or exact IČO numbers).

**Do I need an API key?** No. No key, no login, no scraping.

### Troubleshooting

- **"Search matches too many companies"** → narrow the name, add `addressQuery`, or use `icoList`.
- **No `vat`** → the company isn't VAT-registered (normal for associations and small entities).
- **Many directors on a large company** → ARES keeps history; the newest-appointed are listed first.

### Support

Questions, a field you'd like added, or a custom build? Open the **Issues** tab, or email **info@foxlabs.com.tr**. We reply fast.

*If this Actor saves you time, a ⭐ review really helps.*

### Changelog

#### 0.1 — 2026-07-09

- Initial release. Czech companies from the official ARES registry: identity, IČO, VAT (DIČ), legal form, NACE, address and founding date, with opt-in directors/board, supervisory board and share capital. Open data, no key.

***

Part of the **[foXLabs data platform](https://data.foxlabs.com.tr/)** — official public-data company, contact, ownership, charity, procurement, location & AI-search intelligence scrapers. Browse the full suite at **[data.foxlabs.com.tr](https://data.foxlabs.com.tr/)**.

# Actor input Schema

## `searchQuery` (type: `string`):

Find companies whose name contains this text (case-insensitive). Example: "Škoda", "Alza", "logistika". Leave empty when looking up by IČO.

## `icoList` (type: `array`):

Exact 8-digit Czech company IDs (IČO) for precise lookup, e.g. \["00177041", "27082440"]. Overrides the name search.

## `addressQuery` (type: `string`):

Keep only companies whose registered address contains this text — a city or street (e.g. "Praha", "Brno"). Leave empty for all of Czechia.

## `onlyActive` (type: `boolean`):

Exclude companies that have been dissolved / struck off (have a termination date).

## `includeDirectors` (type: `boolean`):

Attach the statutory body / board (directors' names, roles, tenure), supervisory board and registered share capital from the public register (Veřejný rejstřík). Off by default — adds a lookup per company.

## `maxResults` (type: `integer`):

Maximum number of companies to return (1–100000).

## Actor input object example

```json
{
  "icoList": [],
  "onlyActive": false,
  "includeDirectors": false,
  "maxResults": 1000
}
```

# Actor output Schema

## `dataset` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "",
    "icoList": [],
    "addressQuery": "",
    "maxResults": 1000
};

// Run the Actor and wait for it to finish
const run = await client.actor("foxlabs/czech-company-data").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "",
    "icoList": [],
    "addressQuery": "",
    "maxResults": 1000,
}

# Run the Actor and wait for it to finish
run = client.actor("foxlabs/czech-company-data").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 '{
  "searchQuery": "",
  "icoList": [],
  "addressQuery": "",
  "maxResults": 1000
}' |
apify call foxlabs/czech-company-data --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=foxlabs/czech-company-data",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Czech Company Data — ARES Registry, VAT & Directors",
        "description": "Search 3M+ Czech companies from the official ARES registry (ares.gov.cz) — identity, IČO, VAT (DIČ), legal form, NACE, registered address and founding date, plus optional directors/board (names, roles) and share capital. Open data, no key.",
        "version": "0.1",
        "x-build-id": "82ggNmy1aNfNPo6kW"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/foxlabs~czech-company-data/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-foxlabs-czech-company-data",
                "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/foxlabs~czech-company-data/runs": {
            "post": {
                "operationId": "runs-sync-foxlabs-czech-company-data",
                "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/foxlabs~czech-company-data/run-sync": {
            "post": {
                "operationId": "run-sync-foxlabs-czech-company-data",
                "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": {
                    "searchQuery": {
                        "title": "Company name contains",
                        "type": "string",
                        "description": "Find companies whose name contains this text (case-insensitive). Example: \"Škoda\", \"Alza\", \"logistika\". Leave empty when looking up by IČO."
                    },
                    "icoList": {
                        "title": "IČO numbers",
                        "type": "array",
                        "description": "Exact 8-digit Czech company IDs (IČO) for precise lookup, e.g. [\"00177041\", \"27082440\"]. Overrides the name search.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "addressQuery": {
                        "title": "Address contains",
                        "type": "string",
                        "description": "Keep only companies whose registered address contains this text — a city or street (e.g. \"Praha\", \"Brno\"). Leave empty for all of Czechia."
                    },
                    "onlyActive": {
                        "title": "Only active companies",
                        "type": "boolean",
                        "description": "Exclude companies that have been dissolved / struck off (have a termination date).",
                        "default": false
                    },
                    "includeDirectors": {
                        "title": "Include directors & capital",
                        "type": "boolean",
                        "description": "Attach the statutory body / board (directors' names, roles, tenure), supervisory board and registered share capital from the public register (Veřejný rejstřík). Off by default — adds a lookup per company.",
                        "default": false
                    },
                    "maxResults": {
                        "title": "Max results",
                        "minimum": 1,
                        "maximum": 100000,
                        "type": "integer",
                        "description": "Maximum number of companies to return (1–100000).",
                        "default": 1000
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```