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

```json theme={null}
{
  "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):**

```json theme={null}
{
  "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):**

```json theme={null}
{
  "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):**

```json theme={null}
{
  "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):**

```json theme={null}
{
  "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):**

```json theme={null}
{
  "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):**

```json theme={null}
{
  "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):**

```json theme={null}
{
  "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

## Additional resources

* [Lite Profile Documentation](/documentation/features/verify-basic-details-v1)
* [Enhanced Profile Documentation](/documentation/features/perform-a-kyb-check-v1)
* [Search API Documentation](/documentation/features/search-for-a-company-v1)
