Czech Company Registry (ARES) — By IČO or Search
Pricing
from $0.50 / 1,000 results
Czech Company Registry (ARES) — By IČO or Search
Look up Czech companies in ARES and get flat rows — IČO, name, VAT number, legal form, address, NACE code and registration dates. Free and key-less.
Pricing
from $0.50 / 1,000 results
Rating
0.0
(0)
Developer
alaudin burki
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
21 days ago
Last modified
Categories
Features
Share
Looks up a Czech economic subject in ARES, the state register of economic subjects, using its IČO (the Czech registration number) and returns one flat row: name, VAT number, legal form codes, registered seat, NACE code and registration dates. ARES is a public REST service, so the endpoint needs no key. This Actor performs a record lookup — it sends the IČO in the URL path and maps the response, one entity per run.
How to use
- Put the 8-digit IČO in the
icoinput, e.g.27074358. - Leave
maxItemsandmaxPagesat their defaults; a single lookup returns one record. - Run the Actor. The record lands in the default dataset, and the run's
SUMMARYrecord reports the row count and whether anything went wrong.
Inputs
| Field | What it does | Default |
|---|---|---|
ico | Czech registration number, sent as the path segment of the ARES record endpoint. | 27074358 (the sample value built into the Actor) |
maxItems | Hard row cap. The runner also refuses to go above 20,000. | 500 |
maxPages | Hard request cap. A lookup needs one request. | 5 |
{"ico": "27074358"}
Output
One row per lookup. All values are as ARES returns them; nothing is translated.
| Field | Meaning |
|---|---|
name | Registered name of the subject (obchodniJmeno). |
vatNumber | VAT number (dic), including the CZ prefix, e.g. CZ27074358. Only present for VAT-registered subjects. |
legalFormCode | Legal form code (pravniForma), a number from ARES's code list, e.g. 121 for a joint-stock company. |
legalForm | Legal form code from the ROS code list (pravniFormaRos) — also a code, not a label. |
foundedAt | Date the subject came into existence (datumVzniku). |
updatedAt | Date ARES last changed the record (datumAktualizace), not a change at the company. |
taxOffice | ARES's identifier for the tax office the subject is registered with (financniUrad); the office's name is not returned. |
street | Street of the registered seat (sidlo.nazevUlice), without the house number. |
houseNumber | House number of the registered seat (sidlo.cisloDomovni). |
city | Municipality of the registered seat (sidlo.nazevObce). |
postcode | Postcode of the registered seat (sidlo.pscTxt), as text so leading zeros survive. |
country | Country of the registered seat (sidlo.nazevStatu), in Czech. |
fullAddress | ARES's own formatted address string (sidlo.textovaAdresa), in Czech. |
naceCode | First NACE activity code (czNace[0]). A subject with several activities returns one. |
registerUrl | Link to the subject's page on ares.gov.cz. |
Every row also carries id (ares: followed by the IČO), source (ares-companies) and
scrapedAt (an ISO timestamp for the run); the first two are added by the runner and are not part of
the declared schema. Absent values are dropped from the row, so an unregistered subject has no
vatNumber key at all rather than a null.
Limitations
- One IČO per run. The value is sent as a single record lookup; a comma-separated list is not split into separate lookups in this version. Run once per IČO.
- Both legal form fields are codes.
legalFormCodeandlegalFormcome from two different ARES code lists, and the Czech label for either would have to be joined from ARES's code tables, which this Actor does not do. vatNumberexists only for VAT-registered subjects. It is omitted, not guessed, for the rest.naceCodeis the first entry only. A subject with several registered activities returns the first one ARES lists.- Text is Czech.
city,countryandfullAddressare as ARES holds them, including Czech diacritics and Czech country naming. updatedAtis ARES's last-change date, not a date tied to the subject's own activity.- The record is the register entry only. Financial statements, statutory officers, shareholders and insolvency history are not returned.
- ARES is a register of economic subjects, not only companies. A sole trader's record comes back in the same flat shape as a company's.
- The data is only as fresh as ARES. Changes propagate from the source registers with a lag this
Actor cannot see, and it reports the
updatedAtARES gives it.
Why this is different
This Actor is different because it queries the official ARES record endpoint by the national
identifier instead of scraping a search page, so the IČO you send is the record you get. It requires
no key, returns one flat row per subject with a stable id of ares:<IČO> that can be joined across
runs, and omits absent values instead of filling them with empty strings. Every run also leaves a
SUMMARY record naming why it stopped, so an empty dataset is distinguishable from a failed lookup.
FAQ
Do I need an API key? No. ARES exposes this endpoint publicly and the Actor sends no credentials.
Can I pass several IČO values in one run? Not in this version. The input is sent as a single lookup, so run the Actor once per IČO.
Why are legalFormCode and legalForm numbers rather than names? Both are code-list values in
ARES. Returning a label would mean maintaining ARES's code tables inside the Actor.
What does updatedAt tell me? When ARES last changed this record. It is not the date of a change
at the company.
Does it include financial statements or directors? No. The dataset is the register entry only.
Pricing and limits
The price is shown on the Actor's Apify pricing panel; billing is per event under Apify's
pay-per-event model. A run makes one lookup request, bounded by maxItems (default 500, hard-capped
at 20,000) and maxPages (default 5, hard-capped at 200). If ARES returns no record for the IČO, the
dataset stays empty and the run log says so, rather than filling the row with guesses.