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: 
{
  "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": "62.02",
            "type": "Primary"
          }
        ],
        "addresses": [
          {
            "type": "Business address",
            "fullAddress": "Tartu mnt 53, Tallinn, Harju maakond, Kesklinna linnaosa, 10115, Estonia",
            "buildingName": "Tartu mnt 53",
            "streetName": "Tallinn",
            "city": "Kesklinna linnaosa"
          }
        ],
        "capital": [
          {
            "description": "Capital",
            "classDescription": "Capital",
            "totalNominalValue": 262500.0,
            "currency": "Euro"
          }
        ],
        "representatives": {
          "corporations": [
            {
              "isActive": true,
              "type": "Corporation",
              "name": "John Smith",
              "role": {
                "original": "Member of the management board."
              }
            }
          ]
        },
        "legalForm": {
          "original": "Osaühing (OÜ) "
        },
        "status": {
          "original": "Entered into the register."
        },
        "registrationAuthority": "Registration department of the County Court of Tartu"
      }
    }
  }
}
After (V2 format): 
{
  "data": {
    "data": {
      "data": {
        "activities": [
          {
            "code": "62.02",
            "description": "Computer consultancy activities",
            "type": "Primary"
          }
        ],
        "addresses": [
          {
            "type": "Registered Address",
            "fullAddress": "Harju maakond, Tallinn, Kesklinna linnaosa, Tartu mnt 53",
            "rawAddressLines": [
              "53",
              "Tartu mnt",
              "Kesklinna linnaosa",
              "Tallinn",
              "Harju maakond"
            ],
            "buildingName": "53",
            "streetName": "Tartu mnt",
            "municipality": "Tallinn"
          }
        ],
        "capital": [
          {
            "type": "L",
            "description": "Ordinary ownership",
            "classCode": "L",
            "classDescription": "Ordinary ownership",
            "totalNominalValue": 262500.0,
            "currency": "EUR",
            "shareholdings": [
              {
                "percentage": "100.00",
                "totalNominalValue": 262500.0,
                "shareholders": {
                  "individuals": [
                    {
                      "type": "Person",
                      "idNumber": "12345678901",
                      "name": "JOHN SMITH"
                    }
                  ]
                }
              }
            ]
          }
        ],
        "representatives": {
          "individuals": [
            {
              "role": {
                "original": "JUHL",
                "normalized": "Management board member"
              },
              "startDate": {
                "original": "2025-01-14",
                "normalized": "2025-01-14"
              },
              "isActive": true,
              "powers": [
                "Management board member"
              ],
              "type": "Person",
              "idNumber": "12345678901",
              "name": "JOHN SMITH"
            }
          ]
        },
        "legalForm": {
          "original": "Private limited company"
        },
        "status": {
          "original": "Entered into the register"
        },
        "registrationAuthority": "Centre of Registers and Information Systems"
      }
    }
  }
}

​
Field mapping changes

​
Activity data

Key improvements:
  • Activity description is now included for all activities

​
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)
  • municipality field replaces city for Estonian addresses

​
Capital and shareholdings

Key improvements:
  • shareholdings array is now included with detailed shareholder information
  • Shareholder details include: idNumber, name, type (Person/Corporation), percentage, and totalNominalValue
  • 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”)
Key changes:
  • legalForm.original now provides English translated legal form (e.g., “Private limited company” instead of “Osaühing (OÜ) “)

​
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
    • 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