company-v1Updated: 2026-03-18

Finland Company Data – Search, Lite Profile, Enhanced Profile, and Filing Updates

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 and a cleaner response structure 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):

{
  "companiesField": [
    {
      "addressesField": [
        {
          "lineField": [
            {
              "lineField": "Artjärvi Kk",
              "typeField": "",
              "typeCodeField": ""
            }
          ],
          "typeField": "Registered Office Short Description",
          "addressInOneLineField": "Artjärvi Kk",
          "addressLine1Field": "",
          "addressLine2Field": "",
          "addressLine3Field": "",
          "addressLine4Field": "",
          "cityTownField": "Artjärvi Kk"
        }
      ],
      "aliasesField": [
        null
      ],
      "codeField": "0486256-4",
      "companyIDField": "0486256-4",
      "dateField": "22/03/2026",
      "nameField": "Artjärven Antinkulma Oy",
      "officialField": false,
      "registrationAuthorityField": "Finnish Patent and Registration Office",
      "registrationAuthorityCodeField": "FIPATREK"
    }
  ],
  "transactionIdField": "12437298",
  "responseCodeField": 100
}

After (PRH — number search):

{
  "companiesField": [
    {
      "addressesField": [
        {
          "countryField": "Finland",
          "addressInOneLineField": "PL 212, VIITASAARI, Finland, 44501",
          "addressLine1Field": "PL 212",
          "cityTownField": "VIITASAARI",
          "postcodeField": "44501"
        }
      ],
      "codeField": "0100002-9",
      "companyIDField": "0100002-9",
      "dateField": "2026-03-22T23:49:13.8557304Z",
      "legalFormField": "Limited company",
      "legalStatusField": "Dissolved",
      "nameField": "Artjärven Metalli Oy",
      "officialField": false,
      "registrationAuthorityField": "Finnish Patent and Registration Office",
      "registrationNumberField": "0100002-9",
      "registrationDateField": "1976-04-23"
    }
  ],
  "responseCodeField": 100
}

Key changes

The following fields are now populated in search responses:

legalFormField: Now populated with the company's legal form (e.g., "Limited company", "Limited partnership")
legalStatusField: Now populated with the company's registration status (e.g., "Dissolved", "In the register")
registrationNumberField: Now included, providing the company's registration number
registrationDateField: Now included, providing the company's registration date in ISO format
dateField: Now uses ISO format instead of DD/MM/YYYY
addressesField: Cleaner structure with countryField, postcodeField, and addressLine1Field populated; lineField array removed

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):

{
  "data": {
    "companyProfileField": {
      "activityField": [
        {
          "codeField": "",
          "descriptionField": "Plumbing, heat and air-conditioning installation"
        }
      ],
      "addressesField": [
        {
          "addressInOneLineField": "11 KAUPPATIE ASKOLA 07510",
          "addressLine1Field": "11 KAUPPATIE ASKOLA 07510",
          "addressLine2Field": "",
          "addressLine3Field": "",
          "addressLine4Field": "",
          "cityTownField": "",
          "countryField": "",
          "lineField": [
            {
              "lineField": "",
              "typeCodeField": "",
              "typeField": ""
            }
          ],
          "postcodeField": "",
          "regionStateField": ""
        }
      ],
      "codeField": "0100032-8",
      "dateField": "2026-03-22T23:48:38.1234409Z",
      "foundationDateField": "",
      "legalFormField": "Limited partnership",
      "legalStatusField": "Active",
      "normalizedLegalStatusField": "ACTIVE",
      "nameField": "Laineen Vesilämpö kommandiittiyhtiö",
      "officialField": false,
      "registrationAuthorityField": "Finnish Trade Register",
      "registrationDateField": "1978-03-15"
    },
    "transactionIdField": "0"
  }
}

After (PRH):

{
  "data": {
    "companyProfileField": {
      "activityField": [
        {
          "codeField": "",
          "descriptionField": "Yhtiön toimialana on lvi-alan asennustöiden suorittaminen ja alan tarvikkeiden vähittäiskauppa. Yhtiö voi omistaa kiinteistöjä ja arvopapereita."
        }
      ],
      "addressesField": [
        {
          "addressInOneLineField": "KAUPPATIE 11, Vakkola, Finland, 07510",
          "addressLine1Field": "KAUPPATIE 11",
          "cityTownField": "Vakkola",
          "countryField": "Finland",
          "postcodeField": "07510"
        }
      ],
      "aliasesField": [],
      "codeField": "0100032-8",
      "dateField": "2026-03-22T23:48:42.1443306Z",
      "foundationDateField": "1976-03-05",
      "legalFormField": "Limited partnership",
      "legalStatusField": "In the register",
      "normalizedLegalStatusField": "Active",
      "nameField": "Laineen Vesilämpö kommandiittiyhtiö",
      "officialField": false,
      "registrationAuthorityField": "Finnish Patent and Registration Office",
      "registrationDateField": "1976-03-05",
      "registrationNumberField": "0100032-8"
    },
    "responseCodeField": "100",
    "transactionIdField": "5424470"
  }
}

Field mapping changes

Address structure

The address structure has been improved with better parsing and more populated fields:

Key improvements:

countryField is now populated (e.g., "Finland")
cityTownField and postcodeField are now properly parsed and populated
addressLine1Field now contains just the street address (previously contained the entire address string)
lineField array has been removed in favour of structured address fields
addressLine2Field, addressLine3Field, addressLine4Field, and regionStateField have been removed

Company identification

Key changes:

registrationNumberField is now included, providing the registration number separately from codeField
foundationDateField is now populated with the company's foundation date in ISO format
registrationDateField is now the registration date

Legal form and status

Key changes:

legalStatusField now reflects PRH registry status values (e.g., "In the register", "Registered") instead of EBR values (e.g., "Active")
normalizedLegalStatusField now uses title case ("Active") instead of uppercase ("ACTIVE")
registrationAuthorityField now reads "Finnish Patent and Registration Office" (previously "Finnish Trade Register")

Additional fields

Enhanced profile changes

The response structure has been updated due to the new provider, with improved activity data, cleaner addresses, and updated director role terminology.

Response structure changes

Before (EBR):

{
  "data": {
    "companyProfileField": {
      "activityField": [
        {
          "codeField": "4322",
          "descriptionField": "Plumbing, heat and air conditioning installation"
        }
      ],
      "activityDeclarationField": [
        {
          "declarationField": "Yhtiön toimialana on lvi-alan asennustöiden suorittaminen ja alan tarvikkeiden vähittäiskauppa. Yhtiö voi omistaa kiinteistöjä ja arvopapereita.",
          "declarationDescriptionField": "",
          "languageField": ""
        }
      ],
      "addressesField": [
        {
          "countryField": "Finland",
          "lineField": [
            {
              "lineField": "KAUPPATIE 11",
              "typeField": "",
              "typeCodeField": ""
            },
            {
              "lineField": "07510",
              "typeField": "",
              "typeCodeField": ""
            },
            {
              "lineField": "Vakkola",
              "typeField": "",
              "typeCodeField": ""
            }
          ],
          "typeField": "Postal Address",
          "addressInOneLineField": "KAUPPATIE 11, Vakkola, 07510, Finland",
          "addressLine1Field": "KAUPPATIE 11",
          "cityTownField": "Vakkola",
          "postcodeField": "07510"
        }
      ],
      "aliasesField": [
        null
      ],
      "codeField": "0100032-8",
      "dateField": "2026-03-22T23:27:29.7961912Z",
      "legalFormField": "Kommandiittiyhtiö",
      "legalStatusField": "Registered",
      "normalizedLegalStatusField": "ACTIVE",
      "nameField": "Laineen Vesilämpö kommandiittiyhtiö",
      "officialField": false,
      "registrationAuthorityField": "Finnish Patent and Registration Office",
      "registrationAuthorityCodeField": "FIPATREK",
      "registrationDateField": "1976-03-05",
      "registrationNumberField": "0100032-8",
      "vatNumberField": "FI01000328",
      "directorAndShareDetailsField": {
        "directorsField": [
          {
            "titleField": "Accountable partner",
            "nameField": "Matti Halonen",
            "birthdateField": "1976-07-12",
            "appointedOnField": ""
          },
          {
            "titleField": "Accountable partner",
            "nameField": "Ida Järvenpää",
            "birthdateField": "1972-04-29",
            "appointedOnField": ""
          },
          {
            "titleField": "Silent partner",
            "nameField": "Tomi Eloranta",
            "birthdateField": "1975-04-25",
            "appointedOnField": ""
          },
          {
            "titleField": "Managing Director",
            "nameField": "Matti Halonen",
            "birthdateField": "1958-06-28",
            "appointedOnField": ""
          }
        ]
      }
    },
    "transactionIdField": "5424407",
    "retrievalLocationField": "https://download.kyckr.com/file/1379863771-0"
  }
}

After (PRH):

{
  "data": {
    "companyProfileField": {
      "activityField": [
        {
          "descriptionField": "Yhtiön toimialana on lvi-alan asennustöiden suorittaminen ja alan tarvikkeiden vähittäiskauppa. Yhtiö voi omistaa kiinteistöjä ja arvopapereita.",
          "typeField": "Primary"
        }
      ],
      "addressesField": [
        {
          "countryField": "Finland",
          "addressInOneLineField": "KAUPPATIE 11, Vakkola, Finland, 07510",
          "addressLine1Field": "KAUPPATIE 11",
          "cityTownField": "Vakkola",
          "postcodeField": "07510"
        }
      ],
      "codeField": "0100032-8",
      "dateField": "2026-03-22T23:27:35.0822322Z",
      "foundationDateField": "1976-03-05",
      "legalFormField": "Limited partnership",
      "legalFormDeclarationField": "Limited partnership",
      "legalStatusField": "In the register",
      "normalizedLegalStatusField": "Active",
      "nameField": "Laineen Vesilämpö kommandiittiyhtiö",
      "officialField": false,
      "registrationAuthorityField": "Finnish Patent and Registration Office",
      "registrationDateField": "1976-03-05",
      "registrationNumberField": "0100032-8",
      "directorAndShareDetailsField": {
        "directorsField": [
          {
            "titleField": "Partner",
            "nameField": "Matti Halonen",
            "birthdateField": "1976-07-12"
          },
          {
            "titleField": "Partner",
            "nameField": "Ida Järvenpää",
            "birthdateField": "1972-04-29"
          },
          {
            "titleField": "Silent partner",
            "nameField": "Tomi Eloranta",
            "birthdateField": "1975-04-25"
          },
          {
            "titleField": "Managing Director",
            "nameField": "Matti Halonen",
            "birthdateField": "1958-06-28"
          }
        ]
      }
    },
    "transactionIdField": "5424408",
    "retrievalLocationField": "https://download.kyckr.com/file/812410296-1",
    "responseCodeField": "100"
  }
}

Field mapping changes

Address structure

The address structure has been simplified:

Key improvements:

lineField array has been removed in favour of structured address fields
Address typeField (e.g., "Postal Address") has been removed
addressInOneLineField format slightly changed (country and postcode order)

Directors and representatives

Key changes:

Directors continue to be available with role titles and birth dates
appointedOnField has been removed (previously empty)
Director role titles may differ between providers (e.g., "Accountable partner" → "Partner")

Legal form and status

Key changes:

legalFormField now uses English values (e.g., "Limited partnership") instead of Finnish (e.g., "Kommandiittiyhtiö")
legalFormDeclarationField is now included
legalStatusField now reflects PRH registry status values (e.g., "In the register") instead of EBR values (e.g., "Registered")
normalizedLegalStatusField now uses title case ("Active") instead of uppercase ("ACTIVE")
foundationDateField is now populated

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):

{
  "continuationKeyField": "",
  "productsField": [
    {
      "currencyField": "€",
      "idField": "EBRON_RUJSX0NvbXBhbnlQcm9maWxlXzE=_MDEwMTIzOS02___RUJSX0NQ",
      "priceField": "0",
      "priceTagField": "EBR_CP",
      "productCodeField": "EBR_CompanyProfile_1",
      "productFormatField": "PDF",
      "productTitleField": "Company Profile",
      "vatChargeField": "0"
    },
    {
      "currencyField": "€",
      "idField": "EBRON_RUJSX0NvbXBhbnlPZmZpY2lhbHNfMQ==_MDEwMTIzOS02___RUJSX0NP",
      "priceField": "0",
      "priceTagField": "EBR_CO",
      "productCodeField": "EBR_CompanyOfficials_1",
      "productFormatField": "PDF",
      "productTitleField": "Company Officials",
      "vatChargeField": "0"
    },
    {
      "companyCodeField": "0101239-6",
      "currencyField": "€",
      "deliveryTimeMinutesField": "5",
      "displayDateField": "2026-03-23",
      "idField": "EBROFF_RVRS_RklOX0VUUg==_...",
      "productDetailsField": [
        {
          "documentCountField": 0,
          "keyField": "EFFECTIVE_DATE",
          "valueField": "2026-03-23"
        }
      ],
      "productFormatField": "PDF",
      "productTitleField": "Kaupparekisteriote (Extract from Trade Register)",
      "typeField": "EXTRACT_FROM_TRADE_REGISTER",
      "vatChargeField": "0"
    },
    {
      "companyCodeField": "0101239-6",
      "currencyField": "€",
      "deliveryTimeMinutesField": "5",
      "displayDateField": "1987-06-30",
      "idField": "EBROFF_TUE=_RklOX01B_...",
      "productDetailsField": [
        {
          "documentCountField": 0,
          "keyField": "EFFECTIVE_DATE",
          "valueField": "1987-06-30"
        }
      ],
      "productFormatField": "PDF",
      "productTitleField": "Yhteisösäännöt (Memorandum and Articles of Association)",
      "typeField": "MEMO_AND_ARTICLES",
      "vatChargeField": "0"
    },
    {
      "companyCodeField": "0101239-6",
      "currencyField": "€",
      "deliveryTimeMinutesField": "5",
      "displayDateField": "2024-12-31",
      "idField": "EBROFF_QUE=_RklOX0FB_...",
      "productCodeField": "AA",
      "productDetailsField": [
        {
          "documentCountField": 0,
          "keyField": "EFFECTIVE_DATE",
          "valueField": "2024-12-31"
        }
      ],
      "productFormatField": "ZIP",
      "productTitleField": "Tilinpäätös (Annual Accounts)",
      "typeField": "ANNUAL_ACCOUNT",
      "vatChargeField": "0"
    }
  ],
  "responseCodeField": 100,
  "shouldPayVatField": false,
  "transactionIdField": "72771376"
}

After (PRH):

{
  "productsField": [
    {
      "companyCodeField": "0101239-6",
      "countryISOField": "FI",
      "currencyField": "€",
      "deliveryTimeMinutesField": "5",
      "idField": "REGHUBOFF_Q29vcGVyYXRpdmUgUnVsZXM=_...",
      "priceTagField": "FI_PRH_CR",
      "productFormatField": "PDF",
      "productTitleField": "Cooperative Rules",
      "typeField": "Filing",
      "vatChargeField": "0"
    },
    {
      "companyCodeField": "0101239-6",
      "countryISOField": "FI",
      "currencyField": "€",
      "deliveryTimeMinutesField": "5",
      "idField": "REGHUBOFF_VHJhZGUgUmVnaXN0ZXIgRXh0cmFjdCAtIEZpbm5pc2g=_...",
      "priceTagField": "FI_PRH_TRE",
      "productFormatField": "PDF",
      "productTitleField": "Trade Register Extract - Finnish",
      "typeField": "Filing",
      "vatChargeField": "0"
    }
  ],
  "responseCodeField": 100,
  "shouldPayVatField": false
}

Key changes

Removed products

The following EBR-specific products are no longer available:

Company Profile (EBR_CP) — EBR-sourced company profile PDF
Company Officials (EBR_CO) — 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

Response structure changes

countryISOField is now included on all products (e.g., "FI")
typeField now uses "Filing" for all products (previously used specific type codes like "EXTRACT_FROM_TRADE_REGISTER")
productCodeField, displayDateField, and productDetailsField have been removed
continuationKeyField and transactionIdField have been removed from the response

Finland Company Data – Search, Lite Profile, Enhanced Profile, and Filing Updates

Overview

Search results

New: company number search

Response structure changes

Key changes

Lite profile changes

Response structure changes

Field mapping changes

Address structure

Company identification

Legal form and status

Additional fields

Enhanced profile changes

Response structure changes

Field mapping changes

Address structure

Directors and representatives

Legal form and status

Filing search changes

Response structure changes

Key changes

Removed products

New products

Response structure changes

Additional resources