Skip to main content

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.

​
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: 
{
  "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: 
{
  "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): 
{
  "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): 
{
  "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
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): 
{
  "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): 
{
  "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”)
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