# Finnish Patent and Registration Office

> Look up any company on the Finnish Trade Register in the Business Information System (YTJ), kept by the Finnish Patent and Registration Office. Search companies by name, town, company form, line of business or registration date; read one by its Business ID (Y-tunnus) with its addresses, former names, status, liquidation or bankruptcy, and VAT, prepayment and employer registrations; list what has been registered for it; and validate a Business ID's check digit. No account or API key required.

App · 6 actions. Web page: https://docs.lodol.com/docs/integrations/prh

## Actions

### Find post codes

Find Finnish post codes and their post towns: check a post code on an address, list a town's post codes, or every code in a municipality. Give a post code (or its first digits), a town, or a municipality number.

**Inputs**

- Post code (`post_code`, text): A five-digit post code, or its first digits, such as 026 for every code from 02600 to 02699.
- Town (`town`, text): A post town's name, in the language chosen, such as Espoo (Esbo in Swedish). Pick one, or type it.
- Municipality number (`municipality_code`, text): Statistics Finland's three-digit municipality number, such as 091 for Helsinki or 049 for Espoo.
- Include unused post codes (`include_inactive`, true/false): Also list post codes that are no longer in use. Default: `false`.
- Language (`language`, text): The language of the town names. Defaults to Finnish. One of: `fi` (Finnish), `sv` (Swedish). Default: `fi`.

**Outputs**

- `count` (number): How many rows came back.
- `language` (text): The language of the town names: fi (Finnish) or sv (Swedish).
- `post_codes` (list): The matching post codes, in order.
- `summary` (text): One readable line about the result.

**Example output**

```json
{
  "count": 1,
  "language": "fi",
  "post_codes": [
    {
      "active": true,
      "municipality_code": "049",
      "post_code": "02610",
      "town": "Espoo"
    }
  ],
  "summary": "1 post code found."
}
```

### Get code list

Get one of PRH's code lists with what each code means: company forms, business lines (TOL 2025 or TOL 2008), register entry statuses, registers, name types, Business ID statuses, liquidation and bankruptcy situations, or authorities. Give a word to keep only the codes that contain it, such as 'software' among the business lines.

**Inputs**

- Code list (`code_list`, text, required): Which list to get. One of: `company_forms` (Company forms), `business_lines` (Business lines (TOL 2025)), `business_lines_tol2008` (Business lines (TOL 2008)), `register_statuses` (Register entry statuses), `registers`, `name_types` (Name types), `business_id_statuses` (Business ID statuses), `company_situations` (Liquidation, bankruptcy and reorganisation), `authorities`.
- Language (`language`, text): The language of what each code means. Defaults to English. One of: `en` (English), `fi` (Finnish), `sv` (Swedish). Default: `en`.
- Containing (`contains`, text): Only codes whose code or meaning contains this text, ignoring case. Leave it empty for the whole list.

**Outputs**

- `code_list` (text): Which list this is, e.g. 'company_forms'.
- `code_list_name` (text): The list's name, e.g. 'Company forms'.
- `codes` (list): The codes, in PRH's order.
- `count` (number): How many rows came back.
- `language` (text): The language the words are in: en (English), fi (Finnish) or sv (Swedish).
- `summary` (text): One readable line about the result.

**Example output**

```json
{
  "code_list": "business_lines",
  "code_list_name": "Business lines (TOL 2025)",
  "codes": [
    {
      "code": "70",
      "description": "Activities of head offices and management consultancy",
      "record_code": null
    },
    {
      "code": "701",
      "description": "Activities of head offices",
      "record_code": null
    },
    {
      "code": "7010",
      "description": "Activities of head offices",
      "record_code": null
    },
    {
      "code": "70100",
      "description": "Activities of head offices",
      "record_code": null
    }
  ],
  "count": 4,
  "language": "en",
  "summary": "4 codes in Business lines (TOL 2025) containing 'head offices'."
}
```

### Get company

Look up a Finnish company by its Business ID (Y-tunnus): its name, former and other names, street and postal address, company form, main line of business, website, whether it is on the Trade Register, in liquidation, bankrupt or in reorganisation, and whether it is registered for VAT, in the prepayment register and in the employer register. An ID no company holds comes back with 'found' set to false rather than failing the step.

**Inputs**

- Business ID (`business_id`, text, required): The company's Business ID (Y-tunnus), such as 0112038-9. Its VAT number (FI01120389) works too.
- Language (`language`, text): The language for company forms, business lines, statuses and register names. Town names are Finnish unless Swedish is chosen. Defaults to English. One of: `en` (English), `fi` (Finnish), `sv` (Swedish). Default: `en`.

**Outputs**

- `active` (true/false): True while the company is registered on the Trade Register with a valid Business ID and has not ceased. A company in liquidation or bankruptcy can still be active; see those fields.
- `bankrupt` (true/false): True while the company is in bankruptcy.
- `business_id` (text): The company's Business ID (Y-tunnus), written like 0112038-9.
- `business_id_date` (text): When the Business ID was given, YYYY-MM-DD.
- `business_id_status` (text): The Business ID's own status: Valid, Pending or Business ID invalidated.
- `business_line` (text): The main line of business in words, e.g. 'Activities of head offices'.
- `business_line_classification` (text): Which classification the code is from: 'TOL 2025' for current companies, 'TOL 2008' for many that ceased before 2026.
- `business_line_code` (text): The main line of business as a TOL industry code, e.g. '70100'.
- `company_form` (text): The company form in words, e.g. 'Public limited company'.
- `company_form_code` (text): The company form's code, e.g. 'OYJ', as 'Search companies' takes it.
- `end_date` (text): When the company ceased, YYYY-MM-DD; empty while it exists.
- `euid` (text): The European Unique Identifier used between EU business registers, e.g. 'FIFPRO.0112038-9'.
- `former_names` (list): Names the company used before, most recent first.
- `found` (true/false): True when the register has a company with this Business ID. False means it has none, and every other detail is empty.
- `in_employer_register` (true/false): True while the company is in the employer register (pays regular wages).
- `in_liquidation` (true/false): True while the company is being wound up.
- `in_prepayment_register` (true/false): True while the company is in the prepayment register, so customers need not withhold tax from what they pay it.
- `in_reorganisation` (true/false): True while the company is in corporate restructuring (saneeraus).
- `in_trade_register` (true/false): True while the company is registered on the Trade Register.
- `language` (text): The language the words are in: en (English), fi (Finnish) or sv (Swedish).
- `last_modified` (text): When PRH last changed the record, e.g. '2026-10-22T10:58:46'.
- `name` (text): The company's registered name, e.g. 'Nokia Oyj'.
- `other_names` (list): The company's other current names: parallel names in other languages and auxiliary (trading) names.
- `postal_address` (object): The company's postal address.
- `registers` (list): Every register entry the company has had, current and ended: Trade Register, Tax Administration, prepayment, VAT and employer registers.
- `registration_date` (text): When the company was entered in the Trade Register, YYYY-MM-DD.
- `situations` (list): Every liquidation, bankruptcy or reorganisation registered for the company, past or present.
- `street_address` (object): The company's street address (visiting address).
- `summary` (text): One line in English: name, Business ID, company form, town and where the company stands (on the Trade Register, ceased, in liquidation...).
- `trade_register_status` (text): Where the company stands on the Trade Register: Registered, Ceased, Removed from register, Unregistered or Start-up not registered.
- `vat_number` (text): The EU VAT number the Business ID gives: FI and its eight digits, e.g. 'FI01120389'. It is the company's VAT number only when vat_registered is true.
- `vat_registered` (true/false): True while the company is registered for VAT.
- `website` (text): The website the company registered, e.g. 'www.nokia.com'.

**Example output**

```json
{
  "active": true,
  "bankrupt": false,
  "business_id": "0112038-9",
  "business_id_date": "1978-03-15",
  "business_id_status": "Valid",
  "business_line": "Activities of head offices",
  "business_line_classification": "TOL 2025",
  "business_line_code": "70100",
  "company_form": "Public limited company",
  "company_form_code": "OYJ",
  "end_date": null,
  "euid": "FIFPRO.0112038-9",
  "former_names": [
    {
      "ended_on": "1997-08-31",
      "name": "Oy Nokia Ab",
      "registered_on": "1966-06-10",
      "type": "Company name"
    }
  ],
  "found": true,
  "in_employer_register": true,
  "in_liquidation": false,
  "in_prepayment_register": true,
  "in_reorganisation": false,
  "in_trade_register": true,
  "language": "en",
  "last_modified": "2026-10-22T10:58:46",
  "name": "Nokia Oyj",
  "other_names": [
    {
      "ended_on": null,
      "name": "Nokia Abp",
      "registered_on": "1997-09-01",
      "type": "Parallel company name"
    },
    {
      "ended_on": null,
      "name": "Nokia Corporation",
      "registered_on": "1997-09-01",
      "type": "Parallel company name"
    },
    {
      "ended_on": null,
      "name": "Nokia Networks",
      "registered_on": "2001-10-01",
      "type": "Auxiliary company name"
    },
    {
      "ended_on": null,
      "name": "Nokia Matkapuhelimet",
      "registered_on": "2001-10-01",
      "type": "Auxiliary company name"
    }
  ],
  "postal_address": {
    "care_of": null,
    "country": null,
    "line": "PO Box 226, 00045 Nokia Group",
    "municipality_code": "091",
    "po_box": "226",
    "post_code": "00045",
    "registered_on": "2014-09-30",
    "street": null,
    "town": "Nokia Group"
  },
  "registers": [
    {
      "authority": "Finnish Patent and Registration Office",
      "current": true,
      "ended_on": null,
      "register": "Trade register",
      "register_code": "1",
      "registered_on": "1896-12-19",
      "status": "Registered",
      "status_code": "1"
    },
    {
      "authority": "Tax Administration",
      "current": true,
      "ended_on": null,
      "register": "Tax Administration",
      "register_code": "4",
      "registered_on": "1978-03-15",
      "status": "Registered",
      "status_code": "1"
    },
    {
      "authority": "Tax Administration",
      "current": true,
      "ended_on": null,
      "register": "Prepayment register",
      "register_code": "5",
      "registered_on": "1995-03-01",
      "status": "Registered",
      "status_code": "55"
    },
    {
      "authority": "Tax Administration",
      "current": true,
      "ended_on": null,
      "register": "Value added tax-liability",
      "register_code": "6",
      "registered_on": "1994-06-01",
      "status": "VAT-liable for business activity",
      "status_code": "80"
    },
    {
      "authority": "Tax Administration",
      "current": true,
      "ended_on": null,
      "register": "Value added tax-liability",
      "register_code": "6",
      "registered_on": "1995-01-04",
      "status": "VAT-obliged for the transfer of rights to use immovable property",
      "status_code": "82"
    },
    {
      "authority": "Tax Administration",
      "current": true,
      "ended_on": null,
      "register": "Value added tax-liability",
      "register_code": "6",
      "registered_on": "1995-01-01",
      "status": "VAT-liable for agriculture and forestry",
      "status_code": "83"
    },
    {
      "authority": "Tax Administration",
      "current": true,
      "ended_on": null,
      "register": "Employer register",
      "register_code": "7",
      "registered_on": "1944-01-01",
      "status": "Registered",
      "status_code": "41"
    }
  ],
  "registration_date": "1896-12-19",
  "situations": [],
  "street_address": {
    "care_of": null,
    "country": null,
    "line": "Karakaari 7, 02610 Espoo",
    "municipality_code": "049",
    "po_box": null,
    "post_code": "02610",
    "registered_on": "2019-07-01",
    "street": "Karakaari 7",
    "town": "Espoo"
  },
  "summary": "Nokia Oyj (0112038-9), public limited company, Espoo: on the Trade Register since 1896-12-19.",
  "trade_register_status": "Registered",
  "vat_number": "FI01120389",
  "vat_registered": true,
  "website": "www.nokia.com"
}
```

### List registered notifications

List what has been entered in the Trade Register for a company since November 2014, newest first: changes to the board, managing director, auditors and who may sign for it, share capital, articles of association, mergers and filed financial statements. Useful for checking what changed at a customer or supplier recently.

**Inputs**

- Business ID (`business_id`, text, required): The company's Business ID (Y-tunnus), such as 0112038-9. Its VAT number (FI01120389) works too.
- Registered from (`registered_from`, date): Only notifications registered on or after this day.
- Registered to (`registered_to`, date): Only notifications registered on or before this day.
- Kind of notification (`notice_type`, text): Only notifications of this kind, such as amendment notifications or financial statements. Leave it empty for every kind. One of: `M` (Amendment notification), `U` (Start-up notification), `TA` (Financial statements), `OI` (Rectification), `FUU` (Merger application), `DIF` (Demerger application), `H` (Application), `JH` (Public summons to creditors), `KM` (Municipal change notification), `T` (Notice), `VA` (Supervision).
- Language (`language`, text): The language for company forms, business lines, statuses and register names. Town names are Finnish unless Swedish is chosen. Defaults to English. One of: `en` (English), `fi` (Finnish), `sv` (Swedish). Default: `en`.

**Outputs**

- `business_id` (text): The company's Business ID (Y-tunnus), written like 0112038-9.
- `count` (number): How many rows came back.
- `found` (true/false): True when the register has a company with this Business ID. False means it has none, and every other detail is empty.
- `language` (text): The language the words are in: en (English), fi (Finnish) or sv (Swedish).
- `name` (text): The company's registered name.
- `notifications` (list): The notifications, newest first.
- `summary` (text): One readable line about the result.

**Example output**

```json
{
  "business_id": "0112038-9",
  "count": 4,
  "found": true,
  "language": "en",
  "name": "Nokia Oyj",
  "notifications": [
    {
      "entries": [
        "Authorisation to sign for/to represent the company",
        "Procuration rights"
      ],
      "entry_codes": [
        "NIMO",
        "NIMP"
      ],
      "record_number": "2024/580022",
      "registration_date": "2024-12-11",
      "summary": "2024-12-11 Amendment notification: Authorisation to sign for/to represent the company, Procuration rights",
      "type": "Amendment notification",
      "type_code": "M"
    },
    {
      "entries": [
        "Number of shares",
        "Cancellation of shares",
        "Share capital"
      ],
      "entry_codes": [
        "OSLUKU",
        "OSMIT",
        "OPO"
      ],
      "record_number": "2024/580285",
      "registration_date": "2024-12-04",
      "summary": "2024-12-04 Amendment notification: Number of shares, Cancellation of shares, Share capital",
      "type": "Amendment notification",
      "type_code": "M"
    },
    {
      "entries": [
        "Decision to issue shares",
        "Capital increase",
        "Number of shares"
      ],
      "entry_codes": [
        "ANTIP",
        "KOROI",
        "OSLUKU"
      ],
      "record_number": "2024/559957",
      "registration_date": "2024-11-22",
      "summary": "2024-11-22 Amendment notification: Decision to issue shares, Capital increase, Number of shares",
      "type": "Amendment notification",
      "type_code": "M"
    },
    {
      "entries": [
        "Procuration rights"
      ],
      "entry_codes": [
        "NIMP"
      ],
      "record_number": "2024/490194",
      "registration_date": "2024-10-16",
      "summary": "2024-10-16 Amendment notification: Procuration rights",
      "type": "Amendment notification",
      "type_code": "M"
    }
  ],
  "summary": "4 registered notifications for Nokia Oyj from 2024-10-01 to 2024-12-31."
}
```

### Search companies

Search the Finnish Trade Register's companies by name, town, company form, main line of business, post code, registration date or the date the Business ID was given. Use it to build a lead list ('software companies in Espoo'), to find the company behind a name, or to see who registered this week. Returns 100 companies a page, each with its Business ID for 'Get company'.

**Inputs**

- Company name (`name`, text): A company name, or part of one. Former names, names in other languages and trading names match too.
- Town or city (`location`, text): The post town of the company's address, in Finnish or Swedish, such as Espoo or Esbo. Pick one, or type it.
- Company form (`company_form`, text): Only companies of this form, such as OY (limited company) or OYJ (public limited company).
- Main line of business (`business_line`, text): A TOL 2025 industry code, such as 62100 (computer programming), or words from its name. PRH finds the code anywhere in a company's code, so a shorter one matches more: 62 also finds 46220.
- Post code (`post_code`, text): The five-digit post code of the company's street or postal address.
- Registered from (`registered_from`, date): Only companies entered in the Trade Register on or after this day. With Registered to, a window such as last week.
- Registered to (`registered_to`, date): Only companies entered in the Trade Register on or before this day.
- Business ID given from (`business_id_from`, date): Only companies whose Business ID was given on or after this day.
- Business ID given to (`business_id_to`, date): Only companies whose Business ID was given on or before this day.
- Page (`page`, number): Which page of results, 100 companies to a page. Defaults to 1. At least 1.
- Language (`language`, text): The language for company forms, business lines, statuses and register names. Town names are Finnish unless Swedish is chosen. Defaults to English. One of: `en` (English), `fi` (Finnish), `sv` (Swedish). Default: `en`.

**Outputs**

- `companies` (list): The companies on this page, by Business ID.
- `count` (number): How many rows came back.
- `has_more` (true/false): True when a later page may hold more. A name search's last page can still say true, since its pages count names rather than companies; the page after it then comes back empty.
- `language` (text): The language the words are in: en (English), fi (Finnish) or sv (Swedish).
- `page` (number): The page this is, from 1.
- `summary` (text): One readable line about the result.
- `total_results` (number): How many companies match in all, across every page.

**Example output**

```json
{
  "companies": [
    {
      "active": true,
      "address": "K\u00e4geluddsv\u00e4gen 10, 02150 Espoo",
      "business_id": "0214036-5",
      "business_line": "Activities of head offices",
      "business_line_code": "70100",
      "company_form": "Public limited company",
      "company_form_code": "OYJ",
      "end_date": null,
      "name": "Fiskars Oyj Abp",
      "post_code": "02150",
      "registration_date": "1897-03-08",
      "situations": [],
      "status": "Registered",
      "town": "Espoo",
      "website": "www.fiskarsgroup.com"
    },
    {
      "active": true,
      "address": "Karakaari 7, 02610 Espoo",
      "business_id": "0112038-9",
      "business_line": "Activities of head offices",
      "business_line_code": "70100",
      "company_form": "Public limited company",
      "company_form_code": "OYJ",
      "end_date": null,
      "name": "Nokia Oyj",
      "post_code": "02610",
      "registration_date": "1896-12-19",
      "situations": [],
      "status": "Registered",
      "town": "Espoo",
      "website": "www.nokia.com"
    }
  ],
  "count": 2,
  "has_more": false,
  "language": "en",
  "page": 1,
  "summary": "2 companies match; page 1 has 2.",
  "total_results": 2
}
```

### Validate Business ID

Check that a Finnish Business ID (Y-tunnus) is well formed and its check digit is right, and get it written the standard way with the VAT number it gives. Nothing is sent to PRH, so it is instant; use 'Get company' to see whether a company holds it.

**Inputs**

- Business ID (`business_id`, text, required): The Business ID to check, written any common way: 0112038-9, 01120389 or the VAT number FI01120389.

**Outputs**

- `business_id` (text): The Business ID written the standard way, e.g. '0112038-9'; empty when not valid.
- `input` (text): The text that was checked, as given.
- `reason` (text): Why it is not valid, e.g. a wrong check digit; empty when valid.
- `summary` (text): One readable line about the result.
- `valid` (true/false): True when it is a well-formed Business ID with the right check digit. It does not say a company holds it; 'Get company' does.
- `vat_number` (text): The EU VAT number it gives, e.g. 'FI01120389'; empty when not valid.

**Example output**

```json
{
  "business_id": "0112038-9",
  "input": "FI01120389",
  "reason": null,
  "summary": "0112038-9 is a valid Business ID (VAT number FI01120389).",
  "valid": true,
  "vat_number": "FI01120389"
}
```
