Finland PRH Y-tunnus Portfolio Status Monitor

Watch a list of Finnish Y-tunnukset (suppliers, customers, counterparties) and receive typed status / change events when free official PRH / YTJ open data fields flip — Business ID status, Trade Register status, konkurssi / saneeraus / selvitystila, name, endDate. Not another Finder.fi directory scrape. Not Asiakastieto / Virre paid seats.

Honest coverage (read before buying)

Included (free PRH open data)	Not included
Business ID status (STATUS3: Pending / Valid / Invalidated)	Finder.fi HTML scrapes
Trade Register status (tradeRegisterStatus)	Asiakastieto Critical Alerts! / Tietovahti seats
companySituations: KONK / SANE / SELTILA	Nationwide new-OY lead dumps
Current legal name + optional endDate	Instant streaming; sub-hour guarantees
Lookup by Y-tunnus on your watchlist only	Some entity forms excluded by PRH open data

Live path: per-ID GET https://avoindata.prh.fi/opendata-ytj-api/v3/companies?businessId={ytunnus}. Open data updates about once daily. First observation stores a baseline (no charge). Quiet days ≈ $0 product charges.

Legal: PRH open data expressly free for reuse; no registration/key for the public YTJ open API. Do not treat this as an official PRH product. Default product = Business ID + trade-register status + published insolvency situation codes + name.

Value proposition

• Y-tunnus watchlist × PRH snapshot diff → FI_YTUNNUS_STATUS_CHANGED, FI_TRADE_REGISTER_STATUS_CHANGED, FI_KONKURSSI, FI_SANEERAUS, FI_SELVITYSTILA, FI_NAME_CHANGED, FI_END_DATE_SET, FI_GONE (+ clear variants).
• Official free open data only. No Asiakastieto / Finder / Virre 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 PRH. That fixture path only writes a non-billable RUN_STATUS / FIXTURE_HEALTH row. It is not PRH monitoring.

For production monitoring you must:

1. Set sourceMode = live
2. Provide your businessIds watchlist (Y-tunnukset)
3. Schedule runs (daily is typical; PRH open data is not a sub-hour stream)
4. Optionally set asOfHint (YYYY-MM-DD)

Official references:

• YTJ open data API schema
• PRH open data
• Endpoint: https://avoindata.prh.fi/opendata-ytj-api/v3/companies?businessId={businessId}

Apify Store daily auto-test / default input

Field	Default
businessIds	["0116297-6","0112038-9"]
signalGroups	insolvency, status, identity
sourceMode	fixture
emitFixtureDemoEvents	false
maxRunSeconds	55
requestPaceMs	250

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

Input (summary)

Field	Notes
businessIds	Watchlist (required, Y-tunnus NNNNNNN-C)
signalGroups	insolvency, status, identity
sourceMode	fixture (default) or live
emitFixtureDemoEvents	Default false
asOfHint	Optional as_of hint
maxRunSeconds / maxEvents	Budgets
resumeFromCheckpoint	Default true
requestPaceMs	Default 250 (raise on 429)

Production example

{
  "businessIds": ["0116297-6", "0112038-9", "0210161-4"],
  "signalGroups": ["insolvency", "status", "identity"],
  "sourceMode": "live",
  "asOfHint": "2026-09-17",
  "maxRunSeconds": 300,
  "requestPaceMs": 250,
  "resumeFromCheckpoint": true
}

Output

Change events (billable under PPE)

Typed rows include: business_id, legal_name, event_type, event_subtype, changed_fields, previous_value, new_value, as_of, evidence, summary, source_url, event_uid, company_form, 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: prh-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/finland-prh-ytunnus-portfolio-monitor
npm install
npm test
npm run build
apify run -p

Attribution

Data originates from Patentti- ja rekisterihallitus (PRH) / YTJ open data. Not an official PRH product. Not Finder.fi / Asiakastieto / Virre.