Czech ARES IČO Portfolio Status Monitor

Watch a list of Czech IČO numbers (suppliers, customers, counterparties) and receive typed status / change events when free official ARES REST fields flip — ROS stavZdrojeRos (AKTIVNI / ZANIKLY / …), selected register statuses (VR / RES / RŽP / DPH), obchodní jméno, sídlo, datumZaniku. Not another ARES directory scrape. Not Creditsafe / CRIBIS / Creditinfo seats.

Honest coverage (read before buying)

Included (free ARES REST)	Not included
ROS status (stavZdrojeRos: AKTIVNI / ZANIKLY / POZASTAVENY / …)	Creditsafe / CRIBIS / Creditinfo monitoring seats
Selected registers: VR / RES / RŽP / DPH stavZdroje*	justice.cz HTML scrapes
Obchodní jméno + sídlo (textovaAdresa) + datumZaniku	Nationwide new-s.r.o. lead dumps
Lookup by IČO on your watchlist only	Instant streaming; sub-hour guarantees
Honest multi-register StavZdroje codes	Fake single “active boolean” across all sources

Live path: per-ID GET https://ares.gov.cz/ekonomicke-subjekty-v-be/rest/ekonomicke-subjekty/{ico}. First observation stores a baseline (no charge). Quiet days ≈ $0 product charges. Respect published query-rate limits (requestPaceMs, default 300 ms).

Legal: ARES public REST under Czech open-data / public-sector reuse; no registration/key. Do not treat this as an official Ministry of Finance product. Default product = IČO status / name / seat fields.

Value proposition

• IČO watchlist × ARES snapshot diff → CZ_ARES_ZANIKLY, CZ_ARES_AKTIVNI_RESTORED, CZ_ARES_STATUS_CHANGED, CZ_ARES_REGISTER_STATUS_CHANGED, CZ_ARES_NAME_CHANGED, CZ_ARES_SEAT_CHANGED, CZ_ARES_END_DATE_SET, CZ_ARES_GONE.
• Official free REST only. No Creditsafe / CRIBIS / Creditinfo key.
• Pay only for unique delivered change events. Durable KVS checkpoint + event_uid dedupe.

PRODUCTION USE (required for real monitoring)

Store default ≠ product. Schema defaults use sourceMode=fixture so Apify Store daily auto-tests leave a non-empty health dataset without calling ARES. That fixture path only writes a non-billable RUN_STATUS / FIXTURE_HEALTH row. It is not ARES monitoring.

For production monitoring you must:

1. Set sourceMode = live
2. Provide your icos watchlist (IČO numbers)
3. Schedule runs (daily is typical)
4. Optionally set asOfHint (YYYY-MM-DD)

Official references:

• ARES REST OpenAPI
• ARES portal
• Endpoint: https://ares.gov.cz/ekonomicke-subjekty-v-be/rest/ekonomicke-subjekty/{ico}

Apify Store daily auto-test / default input

Field	Default
icos	["00006947","45274649"]
signalGroups	status, registers, identity
sourceMode	fixture
emitFixtureDemoEvents	false
maxRunSeconds	55
requestPaceMs	300

On that path the Actor SUCCEEDS quickly, pushes exactly one RUN_STATUS / FIXTURE_HEALTH row (billable: false), and does not charge ares-status-event-delivered.

Input (summary)

Field	Notes
icos	Watchlist (required, 8-digit IČO with check digit)
signalGroups	status, registers, identity
sourceMode	fixture (default) or live
emitFixtureDemoEvents	Default false
asOfHint	Optional as_of hint
maxRunSeconds / maxEvents	Budgets
resumeFromCheckpoint	Default true
requestPaceMs	Default 300 (raise on 429)

Production example

{
  "icos": ["00006947", "45274649", "27074358"],
  "signalGroups": ["status", "registers", "identity"],
  "sourceMode": "live",
  "asOfHint": "2026-09-17",
  "maxRunSeconds": 300,
  "requestPaceMs": 300,
  "resumeFromCheckpoint": true
}

Output

Change events (billable under PPE)

Typed rows include: ico, legal_name, event_type, event_subtype, changed_fields, previous_value, new_value, as_of, evidence, summary, source_url, event_uid, ros_status, pravni_forma, billable: true.

RUN_STATUS (never billed)

Every successful run pushes one health row (FIXTURE_HEALTH | MONITOR_IDLE | CATCHUP_COMPLETE | HEALTH_OK).

Pricing

Pay-per-event: ares-status-event-delivered at $0.02 per delivered unique change event ($20 / 1,000). Single tier (see docs/monetization.md and ADR 0010). Health / baseline / duplicate / fixture rows are never charged.

Local development

cd actors/czech-ares-ico-portfolio-monitor
npm install
npm test
npm run build
apify run -p

Attribution

Data originates from Administrativní registr ekonomických subjektů (ARES) / Ministry of Finance ČR. Not an official MoF product. Not Creditsafe / CRIBIS / Creditinfo.