> ## 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.

# Estonia Company Data – Search, Lite Profile, and Enhanced Profile Updates

> Estonia company data updated with improved Search, Lite Profile, and Enhanced Profile responses including better data quality and additional fields.

## Overview

In Kyckr's migration from the EBR (European Business Registry Network), we've updated Search, Lite Profile, and Enhanced Profile responses for Estonia (ISO code EE). Enhanced Profiles remain available and have been improved with better data quality and additional fields.

## Search results

We've improved the structure and data quality of Search responses for Estonia companies.

### Response structure changes

The search response structure has been updated for better consistency and additional company information.

**Before:**

```json theme={null}
{
  "companiesField": [
    {
      "addressesField": [
        {
          "addressInOneLineField": "Rae village, Rae rural municipality, Harju county",
          "addressLine1Field": "",
          "addressLine2Field": "",
          "addressLine3Field": "",
          "addressLine4Field": "",
          "cityTownField": "Rae village, Rae rural municipality, Harju county",
          "lineField": [
            {
              "lineField": "Rae village, Rae rural municipality, Harju county",
              "typeField": "",
              "typeCodeField": ""
            }
          ],
          "typeField": "Registered Office Short Description"
        }
      ],
      "codeField": "10451175",
      "dateField": "27/01/2026",
      "nameField": "DHL Express Estonia AS",
      "registrationAuthorityField": "Registration department of the County Court of Tartu",
      "registrationAuthorityCodeField": "EERDCCTA"
    }
  ],
  "transactionIdField": "11822201"
}
```

**After:**

```json theme={null}
{
  "companiesField": [
    {
      "addressesField": [
        {
          "addressInOneLineField": "Harju maakond, Rae vald, Rae küla, Lennuradari tee 36",
          "addressLine1Field": ""
        }
      ],
      "codeField": "10451175",
      "legalFormField": "Public limited company",
      "legalStatusField": "Entered into the register",
      "nameField": "DHL Express Estonia AS",
      "dateField": "1998-05-14",
      "registrationAuthorityField": "Centre of Registers and Information Systems",
      "registrationNumberField": "10451175",
    }
  ]
}
```

### Key changes

The following fields are now populated in search responses:

* **Address information**: `addressInOneLineField` is now populated with the full Estonian format address
* **Legal form**: `legalFormField` now provides the company's legal form (e.g., "Public limited company")
* **Legal status**: `legalStatusField` now provides the company's legal status (e.g., "Entered into the register")
* **Registration number**: `registrationNumberField` now provides the company's registration number
* **Registration date**: `registrationDateField` now provides the company's registration date in ISO format

The following fields have been removed:

* `registrationAuthorityCodeField` is no longer included
* `lineField`, `cityTownField`, and additional empty address fields have been removed

## Lite profile changes

The response structure has been updated due to the new provider, with improved activity data, address parsing, and additional fields.

### Response structure changes

**Before (V1 format):**

```json theme={null}
{
  "data": {
    "data": {
      "companyProfileField": {
        "activityField": [
          {
            "codeField": "",
            "descriptionField": "53201 - Other postal and courier activities"
          }
        ],
        "addressesField": [
          {
            "addressInOneLineField": "Harju maakond, Rae vald, Rae küla, Lennuradari tee 36, 75310",
            "addressLine1Field": "Harju maakond",
            "addressLine2Field": " Rae vald",
            "addressLine3Field": " Rae küla",
            "addressLine4Field": " Lennuradari tee 36,  75310",
            "cityTownField": "",
            "countryField": "",
            "postcodeField": "",
            "regionStateField": "",
            "lineField": [
              {
                "lineField": "",
                "typeField": "",
                "typeCodeField": ""
              }
            ]
          }
        ],
        "foundationDateField": "",
        "legalFormField": "Public limited company",
        "legalStatusField": "Entered into the register",
        "normalizedLegalStatusField": "ACTIVE",
        "registrationAuthorityField": "Estonian Centre of Registers",
        "registrationDateField": "14.05.1998"
      }
    }
  }
}
```

**After (V1 format):**

```json theme={null}
{
  "data": {
    "data": {
      "companyProfileField": {
        "activityField": [
          {
            "codeField": "52.26",
            "descriptionField": "Other support activities for transportation"
          },
          {
            "codeField": "53.20",
            "descriptionField": "Other postal and courier activities"
          }
        ],
        "addressesField": [
          {
            "addressInOneLineField": "Harju maakond, Rae vald, Rae küla, Lennuradari tee 36",
            "addressLine1Field": "36 Lennuradari tee",
            "cityTownField": "Rae küla",
            "countryField": "Estonia",
            "postcodeField": "75310",
            "regionStateField": "Rae vald",
            "typeField": "Registered Address"
          }
        ],
        "aliasesField": [],
        "foundationDateField": "1998-05-14",
        "legalFormField": "Public limited company",
        "legalStatusField": "Entered into the register",
        "normalizedLegalStatusField": "Active",
        "registrationAuthorityField": "Centre of Registers and Information Systems",
        "registrationDateField": "1998-05-14",
        "registrationNumberField": "10451175",
        "otherIdentifiersField": []
      }
    }
  }
}
```

### Field mapping changes

#### Activity data

**Key improvements:**

* Activity codes (`codeField`) are now populated
* Multiple activities are now captured when available

#### Address structure

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

**Key improvements:**

* `countryField` is now populated (previously empty)
* `cityTownField`, `regionStateField`, and `postcodeField` are now properly parsed and populated

#### 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
* `registrationDateField` format has been improved to ISO format (YYYY-MM-DD) instead of DD.MM.YYYY

#### Legal form and status

**Key changes:**

* Status normalization now uses title case (`"Active"`) instead of uppercase (`"ACTIVE"`)

#### Additional fields

**New fields added:**

* `aliasesField`: Array of company aliases (may be empty)
* `otherIdentifiersField`: Array of other company identifiers (may be empty)

## Enhanced profile changes

The response structure has been updated due to the new provider, with improved data quality across multiple fields.

### Response structure changes

**Before (V1 format):**

```json theme={null}
{
  "data": {
    "data": {
      "companyProfileField": {
        "activityField": [
          {
            "codeField": "53.20",
            "descriptionField": ""
          }
        ],
        "addressesField": [
          {
            "addressInOneLineField": "Lennuradari tee 36, Rae vald, Harju maakond, Rae küla, 75310, Estonia",
            "addressLine1Field": "Lennuradari tee 36",
            "addressLine2Field": "Rae vald",
            "addressLine3Field": "Harju maakond",
            "typeField": "Business address"
          }
        ],
        "capitalField": [
          {
            "ammountField": "50337",
            "currencyField": "Euro",
            "typeField": "Capital",
            "typeCodeField": ""
          }
        ],
        "directorAndShareDetailsField": {
          "directorsField": [
            {
              "titleField": "Member of the management board.",
              "nameField": "Jane Doe",
              "appointedOnField": ""
            },
            {
              "titleField": "Member of the management board.",
              "nameField": "John Smith",
              "appointedOnField": ""
            }
          ]
        },
        "legalFormField": "Aktsiaselts (AS)",
        "legalStatusField": "Entered into the register.",
        "normalizedLegalStatusField": "ACTIVE",
        "registrationAuthorityField": "Registration department of the County Court of Tartu",
        "vatNumberField": "EE100154681"
      }
    }
  }
}
```

**After (V1 format):**

```json theme={null}
{
  "data": {
    "data": {
      "companyProfileField": {
        "activityField": [
          {
            "codeField": "52.26",
            "descriptionField": "Other support activities for transportation"
          },
          {
            "codeField": "53.20",
            "descriptionField": "Other postal and courier activities"
          }
        ],
        "addressesField": [
          {
            "addressInOneLineField": "Harju maakond, Rae vald, Rae küla, Lennuradari tee 36",
            "addressLine1Field": "36 Lennuradari tee",
            "cityTownField": "Rae küla",
            "countryField": "Estonia",
            "postcodeField": "75310",
            "regionStateField": "Rae vald",
            "typeField": "Registered Address"
          }
        ],
        "capitalField": [
          {
            "ammountField": "50,337.00",
            "currencyField": "EUR",
            "typeField": "Ordinary ownership",
            "typeCodeField": "L"
          }
        ],
        "directorAndShareDetailsField": {
          "directorsField": [
            {
              "directorNumberField": "12345678901",
              "titleField": "Management board member",
              "nameField": "John Smith",
              "appointedOnField": "2012-02-03"
            },
            {
              "directorNumberField": "12345678902",
              "titleField": "Management board member",
              "nameField": "Jane Doe",
              "appointedOnField": "2018-12-31"
            }
          ],
          "shareHoldersField": [
            {
              "idField": "HRB8128",
              "nameField": "DEUTSCHE POST BETEILIGUNGEN HOLDING GMBH",
              "percentageField": "100.00",
              "currencyField": "EUR",
              "nominalValueField": "50337.00",
              "shareClassField": "L",
              "shareholderTypeField": "Company",
              "totalShareValueField": 50337
            }
          ]
        },
        "legalFormField": "Public limited company",
        "legalStatusField": "Entered into the register",
        "normalizedLegalStatusField": "Active",
        "registrationAuthorityField": "Centre of Registers and Information Systems",
        "otherIdentifiersField": [
          {
            "typeField": "EE100154681",
            "valueField": "EE_VAT_CD"
          }
        ]
      }
    }
  }
}
```

### Field mapping changes

#### Activity data

**Key improvements:**

* Activity descriptions (`descriptionField`) are now populated alongside codes
* Multiple activities are now captured when available

#### Address structure

The address structure has been improved with better parsing:

* `addressInOneLineField` now uses Estonian format (region first)
* `cityTownField`, `countryField`, `postcodeField`, and `regionStateField` are now populated
* `typeField` now uses standardized descriptions (e.g., "Registered Address" instead of "Business address")

#### Directors and representatives

**Key improvements:**

* `appointedOnField` is now populated with appointment dates in ISO format
* `directorNumberField` is now included for director identification

#### Shareholders

**New fields added:**

* `shareHoldersField` is now populated with share holdings and shareholder details
* Includes shareholder identification (`idField`), name (`nameField`), share percentage (`percentageField`), nominal value (`nominalValueField`), and shareholder type (`shareholderTypeField` - "Person" or "Company")

#### Capital information

**Key improvements:**

* `typeCodeField` is now populated (e.g., "L" for Ordinary ownership)
* `typeField` now uses standardized descriptions (e.g., "Ordinary ownership" instead of "Capital")

#### Legal form and status

**Key changes:**

* `legalFormField` now provides English translated legal form (e.g., "Public limited company" instead of "Aktsiaselts (AS)")
* Status normalization now uses title case (`"Active"`) instead of uppercase (`"ACTIVE"`)

#### Identifiers

**Key changes:**

* `vatNumberField` is deprecated and no longer populated
* `otherIdentifiersField` is now populated and captures VAT numbers where available (e.g., `{"typeField": "EE100154681", "valueField": "EE_VAT_CD"}`)
* This provides a more structured approach to handling various identifier types

## Additional resources

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