Czech Company Registry (ARES) — By IČO or Search avatar

Czech Company Registry (ARES) — By IČO or Search

Pricing

from $0.50 / 1,000 results

Go to Apify Store
Czech Company Registry (ARES) — By IČO or Search

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

alaudin burki

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

21 days ago

Last modified

Features

Limited permissions

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

  1. Put the 8-digit IČO in the ico input, e.g. 27074358.
  2. Leave maxItems and maxPages at their defaults; a single lookup returns one record.
  3. Run the Actor. The record lands in the default dataset, and the run's SUMMARY record reports the row count and whether anything went wrong.

Inputs

FieldWhat it doesDefault
icoCzech registration number, sent as the path segment of the ARES record endpoint.27074358 (the sample value built into the Actor)
maxItemsHard row cap. The runner also refuses to go above 20,000.500
maxPagesHard 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.

FieldMeaning
nameRegistered name of the subject (obchodniJmeno).
vatNumberVAT number (dic), including the CZ prefix, e.g. CZ27074358. Only present for VAT-registered subjects.
legalFormCodeLegal form code (pravniForma), a number from ARES's code list, e.g. 121 for a joint-stock company.
legalFormLegal form code from the ROS code list (pravniFormaRos) — also a code, not a label.
foundedAtDate the subject came into existence (datumVzniku).
updatedAtDate ARES last changed the record (datumAktualizace), not a change at the company.
taxOfficeARES's identifier for the tax office the subject is registered with (financniUrad); the office's name is not returned.
streetStreet of the registered seat (sidlo.nazevUlice), without the house number.
houseNumberHouse number of the registered seat (sidlo.cisloDomovni).
cityMunicipality of the registered seat (sidlo.nazevObce).
postcodePostcode of the registered seat (sidlo.pscTxt), as text so leading zeros survive.
countryCountry of the registered seat (sidlo.nazevStatu), in Czech.
fullAddressARES's own formatted address string (sidlo.textovaAdresa), in Czech.
naceCodeFirst NACE activity code (czNace[0]). A subject with several activities returns one.
registerUrlLink 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. legalFormCode and legalForm come 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.
  • vatNumber exists only for VAT-registered subjects. It is omitted, not guessed, for the rest.
  • naceCode is the first entry only. A subject with several registered activities returns the first one ARES lists.
  • Text is Czech. city, country and fullAddress are as ARES holds them, including Czech diacritics and Czech country naming.
  • updatedAt is 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 updatedAt ARES 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.