company-v2Updated: 2026-01-27

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

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:

{
  "data": [
    {
      "id": "EE|MTA0NTExNzV8RUVSRENDVEE",
      "companyName": "DHL Express Estonia AS",
      "companyNumber": "10451175",
      "address": "Rae village, Rae rural municipality, Harju county",
      "registrationAuthority": "Registration department of the County Court of Tartu"
    }
  ]
}

After:

{
  "data": [
    {
      "id": "EE|MTA0NTExNzU",
      "companyName": "DHL Express Estonia AS",
      "companyNumber": "10451175",
      "address": "Harju maakond, Rae vald, Rae küla, Lennuradari tee 36",
      "status": "Entered into the register",
      "type": "Public limited company",
      "startDate": "1998-05-14",
      "registrationAuthority": "Centre of Registers and Information Systems"
    }
  ]
}

Key changes

  • Address format: Address layout follows the Estonian format received
  • Start date: startDate field is now included, providing the company's start date in ISO format
  • Legal status: status field is now populated (e.g., "Entered into the register")
  • Entity type: type field is now populated (e.g., "Private limited company")

Lite profile changes

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

Response structure changes

Before (V2 format):

{
  "data": {
    "data": {
      "data": {
        "activity": [
          {
            "description": "53201 - Other postal and courier activities",
            "type": "Primary"
          }
        ],
        "address": {
          "fullAddress": "Harju maakond, Rae vald, Rae küla, Lennuradari tee 36, 75310",
          "buildingName": "Harju maakond",
          "streetName": " Rae vald"
        },
        "companyName": "DHL Express Estonia AS",
        "companyNumber": "10451175",
        "foundationDate": {
          "original": "14.05.1998"
        },
        "registrationDate": {
          "original": "14.05.1998"
        },
        "legalForm": {
          "original": "Public limited company"
        },
        "legalStatus": {
          "original": "Entered into the register",
          "normalized": "Active"
        },
        "registrationAuthority": "Estonian Centre of Registers"
      }
    }
  }
}

After (V2 format):

{
  "data": {
    "data": {
      "data": {
        "activity": [
          {
            "code": "52.26",
            "description": "Other support activities for transportation",
            "type": "Primary"
          },
          {
            "code": "53.20",
            "description": "Other postal and courier activities",
            "type": "Primary"
          }
        ],
        "address": {
          "type": "Registered Address",
          "fullAddress": "Harju maakond, Rae vald, Rae küla, Lennuradari tee 36",
          "rawAddressLines": [
            "36",
            "Lennuradari tee",
            "Rae küla",
            "Rae vald",
            "Harju maakond"
          ],
          "buildingName": "36",
          "streetName": "Lennuradari tee",
          "city": "Rae küla",
          "postcode": "75310",
          "municipality": "Rae vald",
          "country": "Estonia"
        },
        "companyName": "DHL Express Estonia AS",
        "companyNumber": "10451175",
        "otherIdentifiers": [],
        "foundationDate": {
          "original": "1998-05-14",
          "normalized": "1998-05-14"
        },
        "registrationDate": {
          "original": "1998-05-14",
          "normalized": "1998-05-14"
        },
        "legalForm": {
          "original": "Public limited company"
        },
        "legalStatus": {
          "original": "Entered into the register",
          "normalized": "Active"
        },
        "registrationAuthority": "Centre of Registers and Information Systems"
      }
    }
  }
}

Field mapping changes

Dissolution date

New field added:

  • dissolutionDate is now populated for companies that have been dissolved, providing both original and normalized date formats

Address structure

The address structure has been enhanced with better parsing and structured fields:

Key improvements:

  • type field is now included to specify the address type (e.g., "Registered Address")
  • Structured fields added: city, country, municipality, postcode
  • rawAddressLines array provides the original address components
  • Address fields are now properly parsed (previously buildingName and streetName contained misaligned data)

Activity data

Activity (NACE code) information is now properly populated:

Key improvements:

  • Activity codes (code) are now populated alongside descriptions
  • Multiple activities are now captured when available

Date fields

Key improvements:

  • Date normalization has been improved for consistency
  • foundationDate and registrationDate now use ISO format (YYYY-MM-DD) in both original and normalized fields
  • Previously dates used DD.MM.YYYY format

Other changes

New fields added:

  • otherIdentifiers array for additional company identifiers
  • dissolutionDate is now populated for dissolved companies

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 (V2 format):

{
  "data": {
    "data": {
      "data": {
        "activities": [
          {
            "code": "46.81",
            "type": "Primary"
          }
        ],
        "addresses": [
          {
            "type": "Business address",
            "fullAddress": "Viljandi mnt 73, Kambja vald, Tartu maakond, Õssu küla, 61713, Estonia",
            "buildingName": "Viljandi mnt 73",
            "streetName": "Kambja vald",
            "city": "Õssu küla",
            "postcode": "61713",
            "country": "Estonia"
          }
        ],
        "capital": [
          {
            "description": "Capital",
            "classDescription": "Capital",
            "totalNominalValue": 191700.0,
            "currency": "Euro"
          }
        ],
        "representatives": {
          "corporations": [
            {
              "role": {
                "original": "Member of the management board."
              },
              "isActive": true,
              "type": "Corporation",
              "name": "Jane Doe"
            },
            {
              "role": {
                "original": "Member of the management board."
              },
              "isActive": true,
              "type": "Corporation",
              "name": "John Smith"
            }
          ]
        },
        "identifiers": {
          "primaryRegistrationNumber": "12345678",
          "taxNumber": "EE123456789"
        },
        "legalForm": {
          "original": "Aktsiaselts (AS)"
        },
        "status": {
          "original": "Entered into the register."
        },
        "registrationAuthority": "Registration department of the County Court of Tartu"
      }
    }
  }
}

After (V2 format):

{
  "data": {
    "data": {
      "data": {
        "activities": [
          {
            "code": "46.72",
            "description": "Wholesale of motor vehicle parts and accessories",
            "classificationScheme": "NACErev2",
            "type": "Primary"
          },
          {
            "code": "46.81",
            "description": "Wholesale of solid, liquid and gaseous fuels and related products",
            "classificationScheme": "NACErev2",
            "type": "Primary"
          }
        ],
        "addresses": [
          {
            "type": "Registered Address",
            "fullAddress": "Tartu maakond, Kambja vald, Õssu küla, Viljandi mnt 73",
            "rawAddressLines": [
              "73",
              "Viljandi mnt",
              "Õssu küla",
              "Kambja vald",
              "Tartu maakond"
            ],
            "streetNumber": "73",
            "streetName": "Viljandi mnt",
            "city": "Õssu küla",
            "postcode": "61713",
            "municipality": "Kambja vald",
            "region": "Tartu maakond",
            "country": "Estonia",
            "isoCode": "EE"
          }
        ],
        "capital": [
          {
            "type": "L",
            "description": "Ordinary ownership",
            "classCode": "L",
            "classDescription": "Ordinary ownership",
            "totalNominalValue": 191700.0,
            "currency": "EUR",
            "shareholdings": [
              {
                "percentage": "50.00",
                "totalNominalValue": 95850.0,
                "shareholders": {
                  "individuals": [
                    {
                      "type": "Person",
                      "idNumber": "12345678901",
                      "name": "John Smith",
                      "birthdate": {
                        "original": "1970-01-15",
                        "normalized": "1970-01-15"
                      },
                      "address": {
                        "isoCode": "EE"
                      }
                    }
                  ]
                }
              },
              {
                "percentage": "50.00",
                "totalNominalValue": 95850.0,
                "shareholders": {
                  "individuals": [
                    {
                      "type": "Person",
                      "idNumber": "12345678902",
                      "name": "Jane Doe",
                      "birthdate": {
                        "original": "1985-06-20",
                        "normalized": "1985-06-20"
                      },
                      "address": {
                        "isoCode": "EE"
                      }
                    }
                  ]
                }
              }
            ]
          }
        ],
        "totalCapital": {
          "totalValue": 191700.0,
          "currency": "EUR"
        },
        "representatives": {
          "individuals": [
            {
              "role": {
                "original": "JUHL",
                "normalized": "Management board member"
              },
              "startDate": {
                "original": "2025-01-23",
                "normalized": "2025-01-23"
              },
              "isActive": true,
              "powers": [
                "Management board member"
              ],
              "type": "Person",
              "idNumber": "12345678902",
              "name": "Jane Doe",
              "birthdate": {
                "original": "1985-06-20",
                "normalized": "1985-06-20"
              }
            }
          ]
        },
        "identifiers": {
          "primaryRegistrationNumber": "12345678",
          "otherIdentifiers": [
            {
              "type": "EE_VAT_CD",
              "value": "EE123456789"
            }
          ]
        },
        "legalForm": {
          "original": "Public limited company"
        },
        "status": {
          "original": "Entered into the register",
          "normalized": "Active"
        },
        "registrationAuthority": "Centre of Registers and Information Systems"
      }
    }
  }
}

Field mapping changes

Activity data

Key improvements:

  • Activity description is now included for all activities
  • classificationScheme field is now included (e.g., "NACErev2")

Address structure

The address structure has been enhanced with better parsing:

  • type now uses standardized descriptions (e.g., "Registered Address" instead of "Business address")
  • rawAddressLines array provides the original address components
  • Address fields are now properly parsed (previously buildingName, streetName, city contained misaligned data)
  • streetNumber field now provides the street number separately
  • municipality and region fields are now included alongside city
  • country and isoCode fields are now populated

Capital and shareholdings

Key improvements:

  • shareholdings array is now included with detailed shareholder information
  • Shareholder details include: idNumber, name, type (Person/Corporation), percentage, totalNominalValue, birthdate, and address
  • currency now uses ISO codes (e.g., "EUR" instead of "Euro")
  • classCode and type fields are now populated
  • description and classDescription now use standardized values (e.g., "Ordinary ownership" instead of "Capital")
  • totalCapital object provides aggregate capital information with totalValue and currency

Shareholding percentage ranges

For certain legal entity types (e.g., Non-profit organisations), the share registry does not support specific ownership percentages. In these cases, shareholding data uses range fields instead of a single percentage value:

Example:

{
  "capital": [
    {
      "classCode": "L",
      "classDescription": "Ordinary ownership",
      "shareholdings": [
        {
          "percentage": null,
          "percentageIsRange": true,
          "percentageRange": "0-100%",
          "percentageLowerLimit": "0",
          "percentageUpperLimit": "100",
          "shareholders": {
            "individuals": [
              {
                "type": "Person",
                "name": "Jane Doe",
                "idNumber": "12345678901"
              }
            ]
          }
        }
      ]
    }
  ]
}

New fields:

  • percentageIsRange: When true, the holding is expressed as a range and percentage is null
  • percentageRange: Human-readable percentage range (e.g., "0-100%")
  • percentageLowerLimit: Lower bound as a numeric string (e.g., "0")
  • percentageUpperLimit: Upper bound as a numeric string (e.g., "100")

Note: With the previous EBR provider, capital and shareholding data was not available for Estonia.

Legal form

Key changes:

  • legalForm.original now provides English translated legal form (e.g., "Public limited company" instead of "Aktsiaselts (AS)")

Status

Key changes:

  • status.normalized is now included alongside status.original (e.g., "Active")

Identifiers

Key changes:

  • taxNumber field is deprecated and replaced by otherIdentifiers array
  • otherIdentifiers array contains additional identifiers with type and value (e.g., {"type": "EE_VAT_CD", "value": "EE123456789"})
  • primaryRegistrationNumber continues to contain the company registration number

Representatives

Key improvements:

  • Representatives are now correctly mapped to individuals or corporations arrays based on entity type (natural person vs legal person)
  • Previously, all representatives were incorrectly mapped to corporations
  • Individual representatives now include:
    • idNumber for identification
    • birthdate with original and normalized values
    • role with both original (Estonian code like "JUHL") and normalized (English translation) values
    • startDate for appointment dates
    • powers array for role descriptions
    • isActive status

Additional resources