> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Finland
> Country-specific identifiers, data sources, and integration details
This guide is outdated and will be removed on 1 November 2026. The up-to-date Finland reference is on the [Finland country page](https://www.topograph.co/countries/fi).
## Start here
This guide contains public integration notes for Finland. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
## Table of Contents
* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Data Availability](#data-availability)
## Data Sources
Finland uses three official data sources: the PRH Trade Register (with the YTJ business information system), the PRH Beneficial Owner Register, and the EU VIES system for VAT verification. Company profile data and legal representatives are **AI-parsed** from the official Trade Register Extract (kaupparekisteriote) PDF document, while activity codes are fetched from the YTJ open data API.
* **PRH VIRRE (Trade Register).** The Finnish Trade Register, maintained by PRH since 1896, is the **primary source** for Finnish entity data. PRH operates the VIRRE information service for fetching Trade Register Extracts and Articles of Association, and for searching companies by name. The Trade Register Extract PDF is AI-parsed to produce structured company data including company name, legal form, status, registered address, share capital, activity description, and legal representatives.
* **PRH ESR (Beneficial Owner Register).** PRH's separate Beneficial Owner Register provides Ultimate Beneficial Owner (UBO) data. Companies are required to register their beneficial owners with PRH. The ESR API returns structured ownership and voting rights data for natural persons who hold significant control over a company.
* **YTJ (Yritys- ja yhteisötietojärjestelmä / Finnish Business Information System).** The YTJ open data API provides structured company data including official TOL (Toimialaluokitus) activity classification codes assigned by Statistics Finland. It is used to search by id and for fetching TOL codes, from which NACE and ISIC codes are derived deterministically.
Finland's data extraction is **document-based**: the system fetches the
official Trade Register Extract PDF from PRH's VIRRE service and uses AI to
parse structured company data from it. This means company profile and legal
representatives are extracted from the same authoritative document. Legal
form, status, activity descriptions, and role classifications are all
AI-parsed from the extract. Activity codes (TOL) are sourced separately from
the YTJ API and mapped deterministically to NACE and ISIC. UBO data comes from
the separate PRH ESR register.
## Company Identifiers
### Query Identifiers
| Company Type | Source | Format | Example | Notes |
| - | - | - | - | - |
| **All companies** | PRH Trade Register | 7 digits + hyphen + check digit, leading zeros significant | `0112038-9` | Business ID (Y-tunnus), validated with check digit algorithm. `/v2/company` also accepts the 8 digits without the hyphen. |
**Business ID (Y-tunnus) Format:** `0112038-9` = 7 digits + hyphen + 1 check
digit. The check digit is calculated using a modulo-11 algorithm. All Finnish
entities registered with PRH receive a Y-tunnus, including limited companies,
partnerships, sole traders, cooperatives, foundations, and associations.
### Identifiers in API Response
Once you retrieve company data, the `identifiers` object contains all available identifiers for that entity:
| Identifier Type | Format | Example | Found In |
| - | - | - | - |
| `businessId` | 7 digits + hyphen + check digit | `0112038-9` | All companies |
| `VAT` | 8 digits (FI prefix stripped) | `01120389` | VAT-registered companies |
| `euid` | Register-issued European identifier | `FIFPRO.0112038-9` | When available |
### Legal Entity Identifier (LEI)
GLEIF is the supplementary data source for this identifier.
`company.identifiers.lei` is optional. It is returned when the Business ID (`businessId`) matches exactly one LEI through a GLEIF registration or validation reference.
The [Legal Entity Identifier](https://www.gleif.org/en/about-lei/introducing-the-legal-entity-identifier-lei) has 20 uppercase alphanumeric characters, ending in two check digits.
Coverage varies by entity. An absent `lei` does not prove that the company has no LEI. Lapsed, retired or merged LEIs may be returned; annulled LEIs are excluded.
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| - | - | - | - | - |
| By Business ID (Y-tunnus) | 7 digits + hyphen + check digit | `1505551-4` | Exact | Exact match returned first (matchType: id); other results may follow |
| By VAT number | `FI` + 8 digits | `FI15055514` | Exact | Resolves to the company with that Business ID |
| By Name | Text string (2-200 chars) | `"Alko"` | Fuzzy | Multiple results |
**Search Performance:** Use Business ID search for best performance and exact
matching. Name searches may return multiple results and support Finnish,
Swedish, and English company names.
Name and Business ID searches cover the full register, including private
traders.
### Active companies only
Search can return companies that are no longer active. [`activeOnly=true`](/essentials/search#active-companies-only) removes those whose status is known at search time; the others are kept. Business ID searches are filtered. Name searches are filtered for companies whose status is known; a company found only by the live name lookup is returned whatever its status.
## Quirks & Gotchas
| Quirk | Details |
| - | - |
| **AI-parsed data** | All company data (profile, status, legal form, legal representatives, activity description) is AI-extracted from the Trade Register Extract PDF. Field availability depends on what is present in the document. |
| **No shareholders** | PRH does not provide shareholder information through the Trade Register. Share ownership is privately held by each company. Only total share capital and share classes are registered with PRH. |
| **UBO availability varies by entity type** | UBO data comes from PRH's ESR register, which is separate from the Trade Register. Only entities required to register beneficial owners will have data. Public limited companies (Oyj), state-owned companies, associations (ry), and foundations (sr) typically declare no beneficial owners or are not in the ESR registry. Sole entrepreneurs (Tmi) are not required to register UBOs. Private limited companies (Oy) are the most likely to have UBO data. |
| **No employee count** | PRH does not provide employee count data. |
| **Processing time** | Company profile and legal representatives are extracted from the Trade Register Extract. See the Speed section of the [pricing page](https://topograph.co/pricing/fi) for current latency. |
| **Trade Register Extract is dual-purpose** | The Trade Register Extract is both the source of structured data (AI-parsed) and a downloadable document. Company profile and legal representatives come from the same document. |
| **Bilingual data** | Finland is bilingual (Finnish and Swedish). Company names, activity descriptions, and legal forms may appear in either language in the Trade Register Extract. Commercial names may include Finnish, Swedish, and English variants. |
| **Articles of Association availability** | Articles of Association are listed for every company registered in the Trade Register, including closed ones, but actual content depends on the company having filed them with PRH. |
| **Pending registrations** | A company whose Trade Register registration is still pending has a Business ID and is searchable, but lists no documents and returns no legal representatives. Its `company` profile comes back with `active: false` and status `INACTIVE_NOT_CLOSED`. |
| **Legal form AI-enriched** | The local Finnish legal form name and its English translation are the labels PRH publishes. Only the standardized category and the ISO 20275 code are AI-enriched. |
| **Activity codes deterministic** | TOL codes are fetched from the YTJ API. NACE and ISIC codes are derived deterministically (TOL first 4 digits = NACE, then formal ISIC mapping). All activity codes have `isAIInferred: false`. Falls back to AI inference if the YTJ API does not return a TOL code. |
| **VAT number format** | The VAT number in the identifiers uses the format without country prefix (e.g., `15055514`), while the `taxId` object includes verification against VIES. |
| **Incorporation date** | Some companies return both `registrationDate` (Trade Register entry) and `incorporationDate` (company formation date), which may differ. |
## Mappings
### Company Status
Company status is **AI-parsed** from the Trade Register Extract document. The AI extracts the current registration status and maps it to standardized status values.
| Local Status | English Translation | Standardized Status | Notes |
| - | - | - | - |
| Rekisterissa | Registered | Active | Company is currently registered and operating |
| Active | Active | Active | Alternative status text in English-language extracts |
| Lakkautettu | Dissolved | Closed | Company has been dissolved |
| Selvitystilassa | In Liquidation | Under Insolvency Proceeding | Liquidation proceedings in progress |
| Konkurssissa | In Bankruptcy | Under Insolvency Proceeding | Bankruptcy proceedings in progress |
| Rekisterista poistettu | Removed from Register | Closed | Company has been removed from the Trade Register |
| Rekisteröimätön | Unregistered | Inactive Not Closed | Business ID issued, registration still pending |
Because status extraction is AI-parsed from the Trade Register Extract
document, the exact local status text may vary. The AI maps Finnish or Swedish
status descriptions to standardized values. The `active` boolean is derived
from the `statusDetails.status` field.
### Legal Forms
Finland uses a variety of legal forms defined in the Trade Register. The local name and English translation are the labels PRH publishes. The standardized category and ISO 20275 code are **AI-enriched**.
#### Key Business Forms
| Finnish Name | Abbreviation | English Translation | Standardized | Notes |
| - | - | - | - | - |
| Osakeyhtiö | Oy | Limited company | Limited Liability Company | Most common Finnish company type |
| Julkinen osakeyhtiö | Oyj | Public Limited Company | Corporation | Listed or public company |
#### Partnerships
| Finnish Name | Abbreviation | English Translation | Standardized | Notes |
| - | - | - | - | - |
| Avoin yhtiö | Ay | General Partnership | Partnership | All partners jointly liable |
| Kommandiittiyhtiö | Ky | Limited Partnership | Partnership | At least one general and one limited partner |
#### Sole Proprietorships
| Finnish Name | Abbreviation | English Translation | Standardized | Notes |
| - | - | - | - | - |
| Yksityinen elinkeinonharjoittaja | Tmi | Sole Trader | Sole Proprietorship | Individual business operator |
#### Cooperatives
| Finnish Name | Abbreviation | English Translation | Standardized | Notes |
| - | - | - | - | - |
| Osuuskunta | Osk | Cooperative | Cooperative | Member-owned cooperative |
#### Non-Profits & Foundations
| Finnish Name | English Translation | Standardized | Notes |
| - | - | - | - |
| Yhdistys | Association | Nonprofit Organization | Registered association |
| Säätiö | Foundation | Nonprofit Organization | Registered foundation |
#### Branch Offices & European Forms
| Finnish Name | English Translation | Standardized | Notes |
| - | - | - | - |
| Sivuliike | Branch | Branch or Representative Office | Branch of a foreign company |
| Eurooppayhtiö (SE) | European Company (SE) | Corporation | Societas Europaea |
| Eurooppaosuuskunta (SCE) | European Cooperative (SCE) | Cooperative | Societas Cooperativa Europaea |
Because legal form standardization and ISO 20275 assignment are AI-enriched,
exact mappings may evolve. The local Finnish legal form name and its English
translation are always PRH's own published labels.
### Legal Representatives
Legal representatives are **AI-parsed** from the Trade Register Extract document. The AI extracts persons from sections such as "Hallitus" (Board), "Toimitusjohtaja" (CEO), and "Edustaminen" (Representation rules), and uses the recorded representation rules to identify legal representatives. Known Finnish and Swedish office titles have fixed English translations and standardized meanings; unfamiliar titles may require enrichment. Finland currently returns no other-key-person list.
| Finnish Role | English Translation | Standardized Role | Classification |
| - | - | - | - |
| Hallituksen puheenjohtaja / Puheenjohtaja | Chairman of the Board | Chairman of the Board | Legal Representative |
| Jäsen (under Hallitus) | Board Member | Board Member | Legal Representative |
| Toimitusjohtaja | Chief Executive Officer | Chief Executive Officer | Legal Representative |
| Varatoimitusjohtaja / Toimitusjohtajan sijainen | Deputy / Substitute CEO | Chief Executive Officer | Legal Representative when acting with recorded authority |
| Finnish Role | English Translation | Standardized Role | Classification |
| - | - | - | - |
| Nimenkirjoittaja / Nimenkirjoitusoikeus | Authorized Signatory | Authorized Signatory | Legal Representative |
| Prokuristi / Prokura | Procuration Holder | Authorized Signatory | Legal Representative |
| Finnish Role | English Translation | Notes |
| - | - | - |
| Tilintarkastaja | Auditor | Excluded from legal representative extraction |
| Varajäsen | Deputy Board Member | Excluded unless representation text explicitly grants rights |
A board's statutory power to represent the company is a power of the board as
a body. An individual board member or chair is included only when the extract
grants that person or role category individual or joint representation rights.
The CEO's statutory authority is limited to the CEO's duties. Procuration also
has a statutory scope. A title alone does not establish unrestricted sole
signing authority. Named signatories with joint rights are included, with the
recorded restrictions preserved.
#### Representation Mode
Legal representatives include a `representationMode` field extracted from the "Edustaminen" (Representation) section of the Trade Register Extract:
* **`{ mode: "sole" }`**: Can sign alone ("yksin")
* **`{ mode: "joint", minimumSignatories: 2 }`**: Must sign jointly with one other ("kaksi yhdessä" / "two jointly")
* **`{ mode: "joint", minimumSignatories: 3 }`**: Must sign jointly with two others ("kolme yhdessä" / "three jointly")
* **`null`**: No signing authority explicitly stated
The field is extracted via AI parsing from Finnish-language text in the Trade Register Extract PDF.
#### Enrichment from Trade Register Extract
The AI parser also extracts:
* **Start dates**: From person-level "Rekisteröity DD.MM.YYYY" dates or section-level registration dates
* **Nationality**: From "Voimassa olevat henkilötiedot" section (e.g., "Suomen kansalainen" = FI)
* **Residence**: City and country from personal details section
### Other Key Persons
Finland currently has no other-key-person output. Auditors ("Tilintarkastajat") are excluded from legal representatives. Board members and deputies without recorded representation powers are also excluded; a deputy with explicit representation rights may appear as a legal representative.
### Shareholders
The Finnish Trade Register (PRH) does **not** provide structured shareholder data. Individual shareholder information is not available through the PRH VIRRE API or the Trade Register Extract.
Shareholder details may appear within the **Articles of Association** document if the company's bylaws reference specific shareholders or share classes, but this is not extracted as structured data.
Finland's Trade Register does not maintain a shareholder register. Share
ownership information is held privately by each company. Only the total share
capital and share classes are registered with PRH.
### Activity Code Mapping
The official TOL (Toimialaluokitus) code is fetched from the YTJ open data API. NACE and ISIC codes are then derived **deterministically** -- no AI inference is involved when TOL is available.
```
TOL (from YTJ API) → NACE Rev. 2.1 (deterministic) → ISIC Rev. 5 (formal mapping)
```
The derivation is straightforward: TOL codes at 4 digits are identical to NACE Rev. 2 class codes (5-digit TOL codes are truncated to 4 digits, as the 5th digit is a Finnish sub-class). ISIC is then derived from NACE using the official UN correspondence table.
| Classification | Source | Example | AI Inferred? |
| - | - | - | - |
| **TOL** | YTJ API (official, assigned by Statistics Finland) | `47250` | No |
| **NACE** | Derived from TOL (first 4 digits → XX.YY) | `47.25` | No |
| **ISIC** | Derived from NACE (formal UN mapping) | `4722` | No |
**One code in, one code out.** You get one `NACE` and one `ISIC` code per declared TOL code. Where a TOL code has no single equivalent in the target revision, the shared parent class is returned rather than every candidate — see [One code in, one code out](/guides/standardization#one-code-in-one-code-out).
**Main activity.** YTJ publishes only the company's main line of business (päätoimiala), so the TOL code carries `isMainActivity: true`, and the NACE and ISIC codes derived from it inherit the flag.
**Deterministic mapping:** When the YTJ API returns a TOL code, all activity
codes (TOL, NACE, ISIC) have `isAIInferred: false`. If the YTJ API does not
return a TOL code for a given company, the system falls back to AI inference
from the Finnish activity description text (in which case `isAIInferred` will
be `true`).
## Supported Entity Families
| Entity Family | Supported | Notes |
| - | - | - |
| Companies | ✅ | Oy, Oyj, Ay, Ky, Osk, SE, SCE, all commercial entity forms |
| Sole traders / entrepreneurs | ✅ | Tmi (Yksityinen elinkeinonharjoittaja) |
| Associations / organisations | ✅ | Yhdistys (associations), Säätiö (foundations) |
| Closed / dissolved entities | ✅ | Lakkautettu (dissolved), Rekisterista poistettu (removed from register) |
## Data Availability
### Data Availability Matrix
| Data Type | All Company Types | Notes |
| - | - | - |
| Company Profile | ✅ Async | AI-parsed from Trade Register Extract |
| Prefill Profile | ✅ Async | Company profile + legal representatives in a single request |
| Legal Representatives | ✅ Async | AI-parsed from Trade Register Extract |
| Shareholders | ❌ | Not available from PRH |
| Ultimate Beneficial Owners | ⚠️ | From PRH ESR register. Available for private limited companies (Oy). Not available for Oyj, state-owned, associations, foundations, or sole entrepreneurs. Verification mode only; not available in prefill mode. |
| Establishments | ❌ | Not available from PRH |
| Activity Codes | ✅ | TOL from YTJ, NACE + ISIC derived deterministically |
| Employee Count | ❌ | Not available from PRH |
| Phone / Website | ❌ | Not available from PRH |
| Commercial Names | ✅ | Finnish, Swedish, and English name variants from PRH |
| Share Capital | ✅ | Amount and currency from Trade Register Extract |
| VAT Verification | ✅ | Verified against EU VIES system |
**Legend:** ✅ Available | ❌ Not Available | ⚠️ Conditionally Available | Async = Asynchronous processing (see the pricing page for current latency)
**Why UBOs are not always available:** Finnish law requires a natural person
to hold >25% of shares or voting rights (or exercise other significant
control) to be registered as a UBO. Public companies (Oyj) have dispersed
ownership below this threshold. State-owned companies have no natural person
owner. Associations, foundations, and cooperatives have no "owners" in the
legal sense. Sole entrepreneurs (Tmi) are not separate legal entities from
their owner, so UBO registration does not apply.
### Documents by Company Type
All Finnish company types registered in the Trade Register have the same documents available:
| Document Type | API Category | Format | Notes |
| - | - | - | - |
| **Trade Register Extract** | `tradeRegisterExtract` | PDF | Official kaupparekisteriote from PRH. Comes with the company data block. Also used as source for AI-parsed company data. |
| **Articles of Association** | `articlesOfAssociation` | PDF | Company bylaws (yhtiöjärjestys), share classes, governance rules. Ordered separately; see the [pricing page](https://topograph.co/pricing/fi). |
**Trade Register Extract Language:** The Trade Register Extract is provided in
Finnish (or Swedish for Swedish-registered companies). There is no English
translation available from PRH. The AI parser handles Finnish/Swedish text
extraction.
Both documents are listed for every company registered in the Trade Register,
including closed ones. Actual content depends on PRH having the document on
file. A company whose registration is still pending lists no documents.
### Example API Responses
All examples use **placeholder data**. Query: `POST /v2/company` with `{ "id": "", "countryCode": "FI", "dataPoints": ["company", "legalRepresentatives"] }`
```json theme={null}
{
"company": {
"id": "1234567-8",
"countryCode": "FI",
"identifiers": { "businessId": "1234567-8", "VAT": "12345678" },
"taxId": { "type": "eu_vat", "value": "12345678", "country": "FI", "verification": { "status": "verified", "verifiedName": "Esimerkki Teknologia Oy" } },
"legalName": "Esimerkki Teknologia Oy",
"commercialNames": ["Esimerkki Teknologia Oy", "Example Technology Ltd"],
"registrationDate": "2019-06-15",
"activityDescription": "Ohjelmistojen suunnittelu ja valmistus",
"status": { "localName": "Active", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "Osakeyhtiö", "englishTranslation": "Limited company", "standardized": "Limited Liability Company", "iso20275Code": "DKUW" },
"capital": { "amount": 2500, "currency": "EUR", "formatted": "2 500.00 EUR" },
"activities": {
"TOL": [{ "code": "62010", "description": "Computer programming activities", "isAIInferred": false }],
"NACE": [{ "code": "62.01", "description": "Computer programming activities", "isAIInferred": false }],
"ISIC": [{ "code": "6201", "description": "Computer programming activities", "isAIInferred": false }]
},
"legalAddress": { "addressLine1": "Mannerheimintie 10", "city": "Helsinki", "postalCode": "00100", "countryCode": "FI" }
},
"legalRepresentatives": [
{ "type": "individual", "entityId": "person_001", "startDate": "2023-04-04", "role": { "localName": "Puheenjohtaja", "englishTranslation": "Chairman of the Board", "standardized": "Chairman of the Board" }, "representationMode": { "mode": "joint", "minimumSignatories": 2 }, "individual": { "name": { "fullName": "Mikko VIRTANEN", "firstName": "Mikko", "lastName": "VIRTANEN" }, "birthDate": { "day": 15, "month": 3, "year": 1980 }, "nationality": "FI", "residenceAddress": { "city": "Helsinki", "countryCode": "FI" } } },
{ "type": "individual", "entityId": "person_002", "startDate": "2023-04-04", "role": { "localName": "Jäsen", "englishTranslation": "Board Member", "standardized": "Board Member" }, "representationMode": { "mode": "joint", "minimumSignatories": 2 }, "individual": { "name": { "fullName": "Anna KORHONEN", "firstName": "Anna", "lastName": "KORHONEN" }, "birthDate": { "day": 22, "month": 7, "year": 1985 }, "nationality": "FI", "residenceAddress": { "city": "Espoo", "countryCode": "FI" } } },
{ "type": "individual", "entityId": "person_003", "startDate": "2019-06-15", "role": { "localName": "Toimitusjohtaja", "englishTranslation": "Chief Executive Officer", "standardized": "Chief Executive Officer" }, "representationMode": { "mode": "sole" }, "individual": { "name": { "fullName": "Pekka MÄKELÄ", "firstName": "Pekka", "lastName": "MÄKELÄ" }, "birthDate": { "day": 1, "month": 11, "year": 1975 }, "nationality": "FI", "residenceAddress": { "city": "Helsinki", "countryCode": "FI" } } }
]
}
```
```json theme={null}
{
"company": {
"id": "9876543-1",
"countryCode": "FI",
"identifiers": { "businessId": "9876543-1", "VAT": "98765431" },
"taxId": { "type": "eu_vat", "value": "98765431", "country": "FI", "verification": { "status": "verified", "verifiedName": "Suuri Teollisuus Oyj" } },
"legalName": "Suuri Teollisuus Oyj",
"commercialNames": ["Suuri Teollisuus Oyj", "Grand Industry Plc"],
"registrationDate": "1990-03-20",
"incorporationDate": "1985-11-01",
"activityDescription": "Teollisuuskoneiden valmistus ja myynti",
"status": { "localName": "Active", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "Julkinen osakeyhtiö", "englishTranslation": "Public Limited Company", "standardized": "Corporation", "iso20275Code": "K6VE" },
"capital": { "amount": 500000, "currency": "EUR", "formatted": "500 000.00 EUR" },
"activities": {
"TOL": [{ "code": "28990", "description": "Manufacture of other special-purpose machinery n.e.c.", "isAIInferred": false }],
"NACE": [{ "code": "28.99", "description": "Manufacture of other special-purpose machinery n.e.c.", "isAIInferred": false }],
"ISIC": [{ "code": "2899", "description": "Manufacture of other special-purpose machinery", "isAIInferred": false }]
},
"legalAddress": { "addressLine1": "Teollisuuskatu 5", "city": "Espoo", "postalCode": "02150", "countryCode": "FI" }
},
"legalRepresentatives": [
{ "type": "individual", "entityId": "person_001", "startDate": "2022-05-10", "role": { "localName": "Puheenjohtaja", "englishTranslation": "Chairman of the Board", "standardized": "Chairman of the Board" }, "representationMode": { "mode": "joint", "minimumSignatories": 2 }, "individual": { "name": { "fullName": "Jukka NIEMI", "firstName": "Jukka", "lastName": "NIEMI" }, "birthDate": { "day": 8, "month": 4, "year": 1968 }, "nationality": "FI", "residenceAddress": { "city": "Espoo", "countryCode": "FI" } } },
{ "type": "individual", "entityId": "person_002", "startDate": "2022-05-10", "role": { "localName": "Jäsen", "englishTranslation": "Board Member", "standardized": "Board Member" }, "representationMode": { "mode": "joint", "minimumSignatories": 2 }, "individual": { "name": { "fullName": "Liisa HÄKKINEN", "firstName": "Liisa", "lastName": "HÄKKINEN" }, "birthDate": { "day": 30, "month": 9, "year": 1972 }, "nationality": "FI", "residenceAddress": { "city": "Helsinki", "countryCode": "FI" } } },
{ "type": "individual", "entityId": "person_003", "startDate": "2020-01-15", "role": { "localName": "Toimitusjohtaja", "englishTranslation": "Chief Executive Officer", "standardized": "Chief Executive Officer" }, "representationMode": { "mode": "sole" }, "individual": { "name": { "fullName": "Markus LAINE", "firstName": "Markus", "lastName": "LAINE" }, "birthDate": { "day": 17, "month": 6, "year": 1970 }, "nationality": "FI", "residenceAddress": { "city": "Helsinki", "countryCode": "FI" } } }
]
}
```
**Note:** Public limited companies (Oyj) follow the same data structure as private limited companies (Oy). The `incorporationDate` may differ from `registrationDate` for older companies.
```json theme={null}
{
"company": {
"id": "5551234-7",
"countryCode": "FI",
"identifiers": { "businessId": "5551234-7", "VAT": "55512347" },
"legalName": "Kauppa ja Palvelut Oy",
"commercialNames": ["Kauppa ja Palvelut Oy"],
"registrationDate": "2005-02-14",
"activityDescription": "Tukkukauppa ja varastointi",
"status": { "localName": "Active", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "Osakeyhtiö", "englishTranslation": "Limited company", "standardized": "Limited Liability Company", "iso20275Code": "DKUW" },
"capital": { "amount": 50000, "currency": "EUR", "formatted": "50 000.00 EUR" },
"activities": {
"TOL": [{ "code": "46900", "description": "Non-specialised wholesale trade", "isAIInferred": false }],
"NACE": [{ "code": "46.90", "description": "Non-specialised wholesale trade", "isAIInferred": false }],
"ISIC": [{ "code": "4690", "description": "Non-specialized wholesale trade", "isAIInferred": false }]
},
"legalAddress": { "addressLine1": "Satamakatu 12", "city": "Turku", "postalCode": "20100", "countryCode": "FI" }
},
"legalRepresentatives": [
{ "type": "individual", "entityId": "person_001", "startDate": "2023-06-01", "role": { "localName": "Puheenjohtaja", "englishTranslation": "Chairman of the Board", "standardized": "Chairman of the Board" }, "representationMode": { "mode": "joint", "minimumSignatories": 2 }, "individual": { "name": { "fullName": "Heikki SALMINEN", "firstName": "Heikki", "lastName": "SALMINEN" }, "nationality": "FI" } },
{ "type": "individual", "entityId": "person_002", "startDate": "2023-06-01", "role": { "localName": "Toimitusjohtaja", "englishTranslation": "Chief Executive Officer", "standardized": "Chief Executive Officer" }, "representationMode": { "mode": "sole" }, "individual": { "name": { "fullName": "Sari NIEMINEN", "firstName": "Sari", "lastName": "NIEMINEN" }, "nationality": "FI" } },
{ "type": "individual", "entityId": "person_003", "startDate": "2023-06-01", "role": { "localName": "Prokuristi", "englishTranslation": "Authorized Signatory", "standardized": "Authorized Signatory" }, "representationMode": { "mode": "joint", "minimumSignatories": 2 }, "individual": { "name": { "fullName": "Timo LAHTINEN", "firstName": "Timo", "lastName": "LAHTINEN" }, "nationality": "FI" } }
]
}
```
**Note:** Procurists (prokura holders) are included as legal representatives with the standardized role "Authorized Signatory". Recorded signing rules appear in `representationMode`; its `particularity` preserves conditions such as required co-signer classes and limits on scope.
Query with `"dataPoints": ["ultimateBeneficialOwners"]` for Holvi Retrieval Services Oy (`2193756-4`):
```json theme={null}
{
"request": {
"companyId": "2193756-4",
"countryCode": "FI",
"requestId": "ca738be0-d117-4f41-8076-61f51e2a6b52",
"dataStatus": {
"dataPoints": {
"ultimateBeneficialOwners": { "status": "succeeded" }
}
}
},
"ultimateBeneficialOwners": [
{
"entityId": "person_001",
"nationality": "FI",
"name": {
"fullName": "Tuomas Matti Toivonen",
"firstName": "Tuomas Matti",
"lastName": "Toivonen"
},
"birthDate": { "day": 25, "month": 2, "year": 1976 },
"residenceAddress": { "city": "Kauniainen", "countryCode": "FI" },
"control": {
"types": ["ownership-of-shares", "voting-rights"],
"description": "Ownership: 100%. Voting rights: 100%. Role: ES",
"details": [
{ "type": "shares", "percentageValue": 100, "nature": "direct" },
{
"type": "voting-rights",
"percentageValue": 100,
"nature": "direct"
}
]
}
}
]
}
```
**Note:** UBO data comes from PRH's ESR register (separate from Trade Register). Control types include `ownership-of-shares`, `voting-rights`, and `significant-influence-or-control`. The `residenceAddress.city` is resolved from the Finnish municipality code (kuntanumero). Companies that declare no beneficial owners return an empty array. Public companies (Oyj), state-owned entities, associations, and foundations typically have no UBO data.
Query with `"dataPoints": ["availableDocuments"]`:
```json theme={null}
{
"documents": {
"tradeRegisterExtract": {
"id": "doc-uuid-001",
"name": "Trade Register Extract",
"format": "pdf",
"description": "Trade register extract from the Finnish Business Registry (PRH)"
},
"articlesOfAssociation": [
{
"id": "doc-uuid-002",
"name": "Article of Association",
"format": "pdf",
"description": "Article of Association from the Finnish Business Registry (PRH)"
}
]
}
}
```
**Note:** Both documents are listed for every company registered in the Trade Register, including closed ones. A company whose registration is still pending lists no documents. The Trade Register Extract is the source document for AI-parsed company data.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.