> ## Documentation Index > Fetch the complete documentation index at: https://developer.kyckr.com/llms.txt > Use this file to discover all available pages before exploring further. # Finland Company Data – Search, Lite Profile, Enhanced Profile, and Filing Updates > Finland Search, Lite Profile, Enhanced Profile, and Filing responses updated following migration from EBR to PRH (Finnish Patent and Registration Office). Company number search is now supported. ## Overview As part of Kyckr's migration from the EBR (European Business Registry Network) to a direct connection with PRH (Finnish Patent and Registration Office), we've updated Search, Lite Profile, Enhanced Profile, and Filing responses for Finland (ISO code FI). All four products remain available and have been improved with richer data, better address parsing, and broader coverage. A key addition is **company number search**, which was not previously available — customers can now search by both company name and registration number. ## Search results Search responses for Finland have been improved with richer data following the direct registry connection. ### New: company number search Previously, Finland search only supported name-based searches. After migration, both **name search** and **number search** are supported. ### Response structure changes **Before (EBR — name search):** ```json theme={null} { "correlationId": "019d1848-1e93-719d-8d33-761df7ba02e1", "cost": { "type": "credit", "value": 0 }, "timeStamp": "2026-03-23T01:21:46.7311655Z", "details": "Success", "data": [ { "id": "FI|MDEwMDAyNC04fEZJUEFUUkVL", "companyName": "Asunto Oy Tammilehto", "companyNumber": "0100024-8", "address": "Artjärvi", "registrationAuthority": "Finnish Patent and Registration Office" } ] } ``` **After (PRH — number search):** ```json theme={null} { "correlationId": "019d184a-5c5a-719d-bf15-624cd6a1dbd1", "cost": { "type": "credit", "value": 0 }, "timeStamp": "2026-03-23T01:23:40.0032039Z", "details": "Success", "data": [ { "id": "FI|MDEwMDAwMi05", "companyName": "Artjärven Metalli Oy", "companyNumber": "0100002-9", "address": "PL 212, VIITASAARI, Finland, 44501", "status": "Dissolved", "type": "Limited company", "startDate": "1976-04-23", "registrationAuthority": "Finnish Patent and Registration Office" } ] } ``` ### Key changes * **address**: Now includes full structured address with street, city, country, and postcode (previously city only) * **status**: New field providing the company's registration status (e.g., "Dissolved", "In the register") * **type**: New field providing the company's legal form (e.g., "Limited company", "Limited partnership", "Housing company") * **startDate**: New field providing the company's registration date in ISO format ## Lite profile changes The response structure has been updated due to the new provider, with improved address parsing, additional fields, and Finnish-language activity descriptions. ### Response structure changes **Before (EBR):** ```json theme={null} { "correlationId": "019d1848-a79a-719d-b112-bba73b7ec6cd", "cost": { "type": "lite", "value": 1 }, "data": { "activity": [ { "description": "Operating of own or leased dwellings and residential real estate", "type": "Primary" } ], "address": { "buildingName": "2 Salmelantie ARTJÄRVI 16200", "fullAddress": "2 Salmelantie ARTJÄRVI 16200" }, "companyName": "Asunto Oy Tammilehto", "companyNumber": "0100024-8", "foundationDate": { "normalized": "1978-03-15", "original": "1978-03-15" }, "legalForm": { "original": "Housing corporation" }, "legalStatus": { "normalized": "Active", "original": "Active" }, "registrationAuthority": "Finnish Trade Register", "registrationDate": { "normalized": "1978-03-15", "original": "1978-03-15" } }, "details": "Success", "timeStamp": "2026-03-23T01:21:48.9784822Z" } ``` **After (PRH):** ```json theme={null} { "correlationId": "019d1848-bd6e-719d-896e-b39c35616ac5", "cost": { "type": "lite", "value": 1 }, "data": { "activity": [ { "description": "Yhtiön toimialana on omistaa ja hallita Tammilehto-nimistä tilaa rek.nro 1:73 Artjärven kunnan Kinttulan kylässä sekä sille rakennettua kerrostaloa, jonka huoneistojen yhteenlasketusta lattiapinta-alasta enin osa varattu osakkeenomistajille asuinhuoneistoiksi.", "type": "Primary" } ], "address": { "city": "Artjärvi", "country": "Finland", "fullAddress": "Salmelantie 2, Artjärvi, Finland, 16200", "isoCode": "FI", "postcode": "16200", "rawAddressLines": [ "Salmelantie 2", "Artjärvi", "Finland", "16200" ], "streetName": "Salmelantie 2" }, "companyName": "Asunto Oy Tammilehto", "companyNumber": "0100024-8", "foundationDate": { "normalized": "1974-12-05", "original": "1974-12-05" }, "legalForm": { "original": "Housing company" }, "legalStatus": { "normalized": "Active", "original": "In the register" }, "registrationAuthority": "Finnish Patent and Registration Office", "registrationDate": { "normalized": "1974-12-05", "original": "1974-12-05" } }, "details": "Success", "timeStamp": "2026-03-23T01:21:54.5843962Z" } ``` ### Field mapping changes #### Address structure The address structure has been enhanced with better parsing and structured fields: **Key improvements:** * `address` is now fully populated with structured fields (previously only `buildingName` and `fullAddress`) * `city`, `country`, `postcode`, and `isoCode` fields are now included * `rawAddressLines` array provides the original address components * `streetName` now contains just the street address * `fullAddress` now provides a properly formatted complete address string * `buildingName` has been removed (previously contained the entire address string) #### Date fields **Key changes:** * `foundationDate` and `registrationDate` values now reflect PRH registry data #### Legal form and status **Key changes:** * `legalForm.original` values now reflect PRH registry terminology (e.g., "Housing company" instead of "Housing corporation") * `legalStatus.original` now provides the registry status (e.g., "In the register") with `normalized` continuing to provide the standardized value (e.g., "Active") * `registrationAuthority` now reads "Finnish Patent and Registration Office" (previously "Finnish Trade Register") ## Enhanced profile changes The response structure has been updated due to the new provider, with improved activity data, consolidated address structure, updated capital format, and changed representative role terminology. ### Response structure changes **Before (EBR):** ```json theme={null} { "data": { "orderId": 5421445, "correlationId": "019d0d94-074c-719d-85cd-ff65cf5166f6", "timeStamp": "2026-03-20T23:28:22.1230872Z", "details": "Success", "data": { "activities": [ { "code": "6820", "description": "Renting and operating of own or leased real estate", "type": "Primary" } ], "addresses": [ { "type": "Visiting Address", "fullAddress": "Salmelantie 2, Artjärvi, 16200, Finland", "buildingName": "Salmelantie 2", "city": "Artjärvi", "postcode": "16200", "country": "Finland" }, { "type": "Postal Address", "fullAddress": "Salmelantie 2, Artjärvi, 16200, Finland", "buildingName": "Salmelantie 2", "city": "Artjärvi", "postcode": "16200", "country": "Finland" }, { "type": "Unspecified" } ], "capital": [ { "description": "Shared capital", "classDescription": "Shared capital", "totalNominalValue": 66617.0, "currency": "Euro" } ], "representatives": { "individuals": [ { "role": { "original": "Chairperson of the Board of Directors" }, "isActive": true, "birthdate": { "original": "1970-11-22", "normalized": "1970-11-22" }, "placeOfResidence": {}, "type": "Person", "name": "Mika Pitkänen" }, { "role": { "original": "Member of the Board of Directors" }, "isActive": true, "birthdate": { "original": "1950-06-13", "normalized": "1950-06-13" }, "placeOfResidence": {}, "type": "Person", "name": "Mikael Toivonen" } ] }, "identifiers": { "primaryRegistrationNumber": "0100024-8", "taxNumber": "FI01000248" }, "companyName": "Asunto Oy Tammilehto", "aliases": [ {} ], "registrationAuthority": "Finnish Patent and Registration Office", "registrationDate": { "original": "1974-12-05", "normalized": "1974-12-05" }, "status": { "original": "Registered", "normalized": "Active" }, "legalForm": { "original": "Asunto-osakeyhtiö" }, "links": { "document": "/orders/5421445/download", "data": "/orders/5421445/download?format=json" } } } } ``` **After (PRH):** ```json theme={null} { "data": { "orderId": 5421446, "correlationId": "019d0d94-28d4-719d-bd68-f6adfa4a4898", "timeStamp": "2026-03-20T23:28:28.0358307Z", "details": "Success", "data": { "activities": [ { "description": "Yhtiön toimialana on omistaa ja hallita Tammilehto-nimistä tilaa rek.nro 1:73 Artjärven kunnan Kinttulan kylässä sekä sille rakennettua kerrostaloa, jonka huoneistojen yhteenlasketusta lattiapinta-alasta enin osa varattu osakkeenomistajille asuinhuoneistoiksi.", "type": "Primary" } ], "addresses": [ { "fullAddress": "Salmelantie 2, Artjärvi, Finland, 16200", "rawAddressLines": [ "Salmelantie 2", "Artjärvi", "Finland", "16200" ], "streetName": "Salmelantie 2", "city": "Artjärvi", "postcode": "16200", "country": "Finland", "isoCode": "FI" } ], "totalCapital": { "totalValue": 66617.56, "quantity": 4890, "currency": "EUR" }, "representatives": { "individuals": [ { "role": { "original": "Chairperson" }, "isActive": false, "birthdate": { "original": "1970-11-22", "normalized": "1970-11-22" }, "type": "Person", "name": "Mika Pitkänen" }, { "role": { "original": "Ordinary member" }, "isActive": true, "birthdate": { "original": "1950-06-13", "normalized": "1950-06-13" }, "type": "Person", "name": "Mikael Toivonen" } ] }, "identifiers": { "primaryRegistrationNumber": "0100024-8" }, "companyName": "Asunto Oy Tammilehto", "registrationAuthority": "Finnish Patent and Registration Office", "foundationDate": { "original": "1974-12-05", "normalized": "1974-12-05" }, "registrationDate": { "original": "1974-12-05", "normalized": "1974-12-05" }, "status": { "original": "In the register", "normalized": "Active" }, "legalForm": { "original": "Housing company" }, "links": { "document": "/orders/5421446/download", "data": "/orders/5421446/download?format=json" } } } } ``` ### Field mapping changes #### Address structure The address structure has been consolidated and enhanced: **Key improvements:** * Multiple address types (Visiting Address, Postal Address, Unspecified) are consolidated into a single structured address * `rawAddressLines` array now provides the original address components * `streetName` now contains the street address (previously `buildingName` was used) * `isoCode` field is now included (e.g., "FI") * `buildingName` and `type` have been removed * `fullAddress` format slightly changed (country and postcode order) #### Capital information **Key changes:** * `capital` was only populated with issued capital which has been replaced by `totalCapital` object * New structure uses `totalValue`, `quantity`, and `currency` (ISO code "EUR") instead of `description`, `classDescription`, `totalNominalValue`, and `currency` (full name "Euro") #### Representatives **Key changes:** * Representative role titles are now shortened (e.g., "Chairperson of the Board of Directors" → "Chairperson", "Member of the Board of Directors" → "Ordinary member") * `isActive` may now reflect current registry status more accurately #### Identifiers **Key changes:** * `primaryRegistrationNumber` continues to be available * `aliases` with empty objects has been removed #### Additional fields **Key improvements:** * `foundationDate` is now included with `original` and `normalized` values #### Legal form and status **Key changes:** * `legalForm.original` now uses English values (e.g., "Housing company") instead of Finnish (e.g., "Asunto-osakeyhtiö") * `status.original` now reflects PRH registry status values (e.g., "In the register") instead of EBR values (e.g., "Registered"); `normalized` continues to provide "Active" ## Filing search changes The filing search response has been updated following the migration to the direct PRH connection. The available document types have changed, with EBR-specific products removed and new PRH document types added. The specific documents available vary by company type. ### Response structure changes **Before (EBR):** ```json theme={null} { "correlationId": "019d1a04-c43e-719d-91a8-9041d4005036", "cost": { "type": "credit", "value": 0 }, "data": [ { "deliveryTimeMinutes": 0, "documentFormat": [ "application/pdf" ], "id": "fEVCUk9OX1JVSlNYME52YlhCaGJubFFjbTltYVd4bFh6RT1f...", "name": "Company Profile" }, { "deliveryTimeMinutes": 0, "documentFormat": [ "application/pdf" ], "id": "fEVCUk9OX1JVSlNYME52YlhCaGJubFBabVpwWTJsaGJITmZNUT09X...", "name": "Company Officials" }, { "deliveryTimeMinutes": 5, "documentDate": "2026-03-23", "documentFormat": [ "application/pdf" ], "id": "fEVCUk9GRl9SVlJTX1JrbE9YMFZVVWc9PV9TMkYxY0hCaGNtVnJhWE4w...", "name": "Kaupparekisteriote (Extract from Trade Register)" }, { "deliveryTimeMinutes": 5, "documentDate": "1987-06-30", "documentFormat": [ "application/pdf" ], "id": "fEVCUk9GRl9UVUU9X1JrbE9YMDFCX1dXaDBaV2x6dzdaenc2VERwRzV1dz...", "name": "Yhteisösäännöt (Memorandum and Articles of Association)" }, { "deliveryTimeMinutes": 5, "documentDate": "2024-12-31", "documentFormat": [ "application/zip" ], "id": "fEVCUk9GRl9RVUU9X1JrbE9YMEZCX1ZHbHNhVzV3dzZURHBIVER0bk1n...", "name": "Tilinpäätös (Annual Accounts)" } ], "details": "Success", "timeStamp": "2026-03-23T09:27:07.0309797Z" } ``` **After (PRH):** ```json theme={null} { "correlationId": "019d1a05-a898-719d-bc2f-fc2013622d03", "cost": { "type": "credit", "value": 0 }, "data": [ { "category": "Filing", "deliveryTimeMinutes": 5, "documentFormat": [ "application/pdf" ], "id": "UkVHSFVCT0ZGfDAxMDEyMzktNnxGSV9QUkhfQ1J8MTA3fENvb3BlcmF0aXZlIFJ1bGVz", "name": "Cooperative Rules" }, { "category": "Filing", "deliveryTimeMinutes": 5, "documentFormat": [ "application/pdf" ], "id": "UkVHSFVCT0ZGfDAxMDEyMzktNnxGSV9QUkhfVFJFfDEwN3xUcmFkZSBSZWdpc3RlciBFeHRyYWN0IC0gRmlubmlzaA==", "name": "Trade Register Extract - Finnish" } ], "details": "Success", "timeStamp": "2026-03-23T09:27:51.8168413Z" } ``` ### Key changes #### Removed products The following EBR-specific products are no longer available: * **Company Profile** — EBR-sourced company profile PDF * **Company Officials** — EBR-sourced company officials PDF #### New products The specific documents available depend on company type. Examples of PRH document types now available: | Product | Format | | ------------------------------------ | ------ | | **Cooperative Rules** | PDF | | **Trade Register Extract - Finnish** | PDF | ## Additional resources * [Lite Profile Documentation](/documentation/features/verify-basic-details-v2) * [Enhanced Profile Documentation](/documentation/features/perform-a-kyb-check-v2) * [Search API Documentation](/documentation/features/search-for-a-company-v2)