# Finnish Company Data & Financials (PRH / YTJ) (`stimulating_stilbite/finnish-company-data-financials`) Actor

Finnish company lookup by Y-tunnus (Business ID), name or filters (city, TOL industry, company form, registration date): status, address, VAT, LEI plus revenue, profit, equity from PRH open data and ESEF reports. No scraping.

- **URL**: https://apify.com/stimulating_stilbite/finnish-company-data-financials.md
- **Developed by:** [Nordic Data Tools](https://apify.com/stimulating_stilbite) (community)
- **Categories:** Lead generation, Business, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Finnish Company Data & Financials API (PRH / YTJ open data)

Look up **Finnish companies by Y-tunnus (Business ID), by name, or build lead lists by city, postcode, TOL 2008 industry code, company form and registration date** — and get clean JSON/CSV/Excel with status (incl. liquidation, bankruptcy, restructuring), addresses, main line of business, VAT and employer registration, LEI, plus **revenue, operating profit, net profit, total assets, equity and liabilities** from official digital financial statements.

Built only on **official open data**: the Finnish Patent and Registration Office's **PRH / YTJ open data API** and **open XBRL financial-statement API** (CC BY 4.0), the **GLEIF** LEI register (CC0) and **ESEF** annual reports of listed companies. **No scraping of Finder, Asiakastieto, Kauppalehti or Fonecta** — no blocked runs and no ToS risk.

👉 Click **Try for free** — the input is prefilled with three real companies and returns in a few seconds.

### How to get started

1. Leave the prefilled Business IDs (Nokia, KONE, Peltisepänliike Nykänen) and click **Start** / **Try for free**.
2. Replace them with your own Y-tunnus list, or type names, or leave both empty and use the **filters** (e.g. `city: "Tampere"`, `industryCode: "62"`, `registeredFrom: "2026-01-01"`) for a lead list.
3. Call it from code, Make, Zapier, n8n or an AI agent and read the dataset.

### What you get

| Field | Real example (Peltisepänliike Nykänen Oy) |
|---|---|
| `businessId`, `euId`, `lei` | `0399677-1`, `FIFPRO.0399677-1` |
| `name`, `otherNames`, `previousNames` | `Peltisepänliike Nykänen Oy` |
| `legalForm`, `legalFormLocal`, `legalFormCode` | `Limited company`, `Osakeyhtiö`, `OY` |
| `status`, `situations` | `Active` / `Active – Liquidation` / `Active – Bankruptcy` / `Ceased / removed` |
| `registrationDate`, `businessIdDate` | `1983-12-08` |
| `city`, `streetAddress`, `postalAddress` | `VETELI`, `{"street": "NYKÄSENTIE 669", "postalCode": "69700", "city": "VETELI"}` |
| `mainBusinessLine` | `{"code": "43220", "description": "Plumbing, heat and air-conditioning installation"}` |
| `website`, `vatRegistered`, `employerRegistered`, `registers` | register memberships with dates |
| `financials.revenue` (liikevaihto) | `11043968.05` |
| `financials.operatingProfit` (liikevoitto) | `1364007.95` |
| `financials.profitBeforeAppropriationsAndTaxes`, `netProfit` | `1442266.95`, `1165155.66` |
| `financials.totalAssets`, `equity`, `totalLiabilities`, `equityRatioPercent` | `11375535.23`, `9737340.29`, `1638194.94`, `85.6` |
| `financials.fiscalYearStart` / `fiscalYearEnd` / `currency` | `2025-04-01` / `2026-03-31` / `EUR` |
| `financialsPreviousYear` | prior-year comparatives from the same statement |
| `financialsSource`, `financialsDocumentUrl`, `ytjUrl`, `dataSources` | provenance and links |
| `error` | why a company couldn't be returned (not charged) |

### Real output (run on 18 Nov 2026)

| businessId | name | city | FY end | revenue (EUR) | operating profit | net profit | equity | source |
|---|---|---|---|---:|---:|---:|---:|---|
| 0112038-9 | Nokia Oyj | Espoo | 2025-12-31 | 19 889 000 000 | 885 000 000 | 660 000 000 | 21 058 000 000 | ESEF |
| 1927400-1 | KONE Oyj | Helsinki | 2025-12-31 | 11 245 200 000 | 1 336 200 000 | 991 900 000 | 2 826 800 000 | ESEF |
| 0111316-2 | Marimekko Oyj | Helsinki | 2025-12-31 | 189 600 000 | 31 800 000 | 24 400 000 | 74 300 000 | ESEF |
| 0399677-1 | Peltisepänliike Nykänen Oy | Veteli | 2026-03-31 | 11 043 968 | 1 364 008 | 1 165 156 | 9 737 340 | PRH iXBRL |

### Input examples

**By Business ID:**

```json
{ "businessIds": ["0112038-9", "1927400-1"], "includeFinancials": true }
```

**By name:**

```json
{ "companyNames": ["KONE", "Fiskars"], "maxResultsPerName": 2 }
```

**Lead list — software companies registered in Tampere this year:**

```json
{ "city": "Tampere", "industryCode": "62", "companyForm": "OY", "registeredFrom": "2026-01-01", "maxResults": 500 }
```

**From Python:**

```python
from apify_client import ApifyClient
client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("stimulating_stilbite/finnish-company-data-financials").call(
    run_input={"businessIds": ["1927400-1"]})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["name"], item["status"], (item["financials"] or {}).get("revenue"))
```

### Use cases

- **Lead generation:** newly registered companies by city, postcode and industry, with website and VAT/employer status.
- **KYB / supplier onboarding:** valid Business ID? Liquidation, bankruptcy or restructuring? VAT-registered? LEI?
- **Credit checks:** revenue, profit, equity and liabilities with prior-year comparison, linked to the source filing.
- **CRM enrichment:** via API, Make, Zapier, n8n or Google Sheets.
- **AI agents & MCP:** callable through the [Apify MCP server](https://mcp.apify.com) (*"is Finnish company 0399677-1 active and what was its revenue?"*).

### Coverage — please read

- **Registry data:** every company and organisation in PRH's open YTJ data (limited companies, co-operatives, partnerships, associations, foundations, housing companies…). **Sole traders (toiminimi) are not in PRH open data** and therefore not returned.
- **Financials — honest scope:** Finland has no free bulk register of all annual accounts. This Actor returns figures where they are openly published:
  - **PRH open XBRL API:** statements filed digitally in iXBRL format — PRH states this is **about 5% of all financial statements**, growing every year;
  - **ESEF annual reports** for listed companies (Nokia, KONE, Marimekko…) via filings.xbrl.org.
    For other companies `financials` is `null` — and you are not charged for financials that don't exist.
- **Not included:** board members, owners, phone numbers, e-mails (not in the open data).
- Invalid or unknown Business IDs return an item with `error` and are **not charged**.

### Pricing

Free to use while in early access — you only pay the small Apify platform usage of your runs. If pay-per-result pricing is introduced, error items will stay free and the change will be announced here first.

### Troubleshooting

- **"Provide business IDs, company names, or at least one search filter"** — add at least one.
- **`error`: invalid Business ID** — format `1234567-8`; the check digit is validated.
- **`financials` is null** — the company hasn't filed an iXBRL statement and isn't listed (see Coverage).
- **Name search misses a company** — use the Business ID for exact results; very generic names have thousands of matches.
- **Still stuck?** Open an issue on the **Issues** tab with the run ID.

### More Nordic company data

Same output style, same honest coverage notes, official open data only — from **Nordic Data Tools**:

- 🇸🇪 [Swedish Company Data & Financials (Bolagsverket)](https://apify.com/stimulating_stilbite/swedish-company-data-financials)
- 🇳🇴 [Norwegian Company Data & Financials (Brønnøysund)](https://apify.com/stimulating_stilbite/norwegian-company-data-financials)
- 🇫🇮 [Finnish Company Data & Financials (PRH / YTJ)](https://apify.com/stimulating_stilbite/finnish-company-data-financials)

### Changelog

#### 0.1 (18 Nov 2026)

- First public release: lookup by Business ID or name, filter-based lead lists, PRH iXBRL and ESEF financials.

### Data sources and licences

- Finnish Patent and Registration Office (PRH) — YTJ open data API and open XBRL financial-statement API, **CC BY 4.0**. Source: PRH / avoindata.prh.fi.
- GLEIF — Global LEI Index (CC0).
- filings.xbrl.org — ESEF annual reports of listed issuers.

This Actor isn't affiliated with PRH, the Finnish Tax Administration or GLEIF.

***

#### Suomeksi

Hae **suomalaisten yritysten tiedot Y-tunnuksella**, nimellä tai suodattimilla (kunta, postinumero, TOL-toimiala, yritysmuoto, rekisteröintipäivä): tila (selvitystila, konkurssi, saneeraus), osoitteet, päätoimiala, ALV- ja työnantajarekisteröinti sekä **liikevaihto, liikevoitto, tilikauden tulos, oma pääoma ja taseen loppusumma** digitaalisista tilinpäätöksistä. Vain PRH:n avointa dataa (CC BY 4.0) — ei verkkosivujen kaapimista.

# Actor input Schema

## `businessIds` (type: `array`):

Finnish Business IDs in the form 1234567-8 (FI12345678 and IDs without the leading zero are accepted). Invalid IDs return an error item and are not charged.

## `companyNames` (type: `array`):

Free-text names, e.g. "KONE" or "Marimekko". Searches current and previous names in YTJ plus the GLEIF LEI register, ranks exact matches first and returns up to maxResultsPerName per name.

## `maxResultsPerName` (type: `integer`):

Maximum matches per company name (1-50). Default 3.

## `city` (type: `string`):

Filter by town or city of the company address, e.g. Helsinki, Espoo, Tampere, Oulu.

## `postCode` (type: `string`):

Filter by 5-digit postal code, e.g. 00100.

## `industryCode` (type: `string`):

Main line of business code from Statistics Finland TOL 2008, e.g. 62 (computer programming), 62010, 43220 (plumbing), 56101 (restaurants). Numeric codes match as prefix.

## `companyForm` (type: `string`):

Filter by company form code, e.g. OY (limited company) or OYJ (public limited company).

## `registeredFrom` (type: `string`):

Company registration date on or after (YYYY-MM-DD).

## `registeredTo` (type: `string`):

Company registration date on or before (YYYY-MM-DD).

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

Skip ceased or removed companies in name and filter searches. Direct Business ID lookups always return the company.

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

Maximum companies returned when listing by filters (1-5000). Default 100.

## `includeFinancials` (type: `boolean`):

Add revenue, operating profit, profit before appropriations and taxes, net profit, total assets, equity, liabilities and equity ratio from the latest digital financial statement filed to PRH (iXBRL, with prior-year comparatives), or from the ESEF annual report for listed companies.

## Actor input object example

```json
{
  "businessIds": [
    "0112038-9",
    "1927400-1",
    "0399677-1"
  ],
  "companyNames": [
    "KONE",
    "Marimekko"
  ],
  "maxResultsPerName": 3,
  "onlyActive": true,
  "maxResults": 100,
  "includeFinancials": true
}
```

# Actor output Schema

## `overview` (type: `string`):

Key registry fields and headline financials (table).

## `financials` (type: `string`):

Latest-year financial figures (table).

## `allData` (type: `string`):

Full records with every field.

# 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 = {
    "businessIds": [
        "0112038-9",
        "1927400-1",
        "0399677-1"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("stimulating_stilbite/finnish-company-data-financials").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 = { "businessIds": [
        "0112038-9",
        "1927400-1",
        "0399677-1",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("stimulating_stilbite/finnish-company-data-financials").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "businessIds": [
    "0112038-9",
    "1927400-1",
    "0399677-1"
  ]
}' |
apify call stimulating_stilbite/finnish-company-data-financials --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,stimulating_stilbite/finnish-company-data-financials"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/s7v0qhDFytqogg6Yt/builds/oHYPLaNDlXLOclhYP/openapi.json
