- Developer newsUpdates to the API
- Gibraltar Company Data – Search and Lite Profile Updates
- Jersey Company Data – Search and Lite Profile Updates
- Slovenia Company Data – Search, Lite Profile, and Filing List Updates
- Luxembourg Enhanced Profile – Shareholder Data Improvements
- Latvia Company Data – Search, Lite Profile, and Enhanced Profile Updates
- UBO Verify – Release Note
- British Virgin Islands (BVI) Company Data Now Available
- Estonia Company Data – Search, Lite Profile, and Enhanced Profile Updates
- Lithuania Company Data – Enhanced Profiles Removed, Search and Lite Profile Updates
- Enhanced UK Company Data – Director Information Improvements
- New Canada integration for search, lite profile and company profile documents
- Italian company identifier changed from codice fiscale to REA
- IntroductionAbout the Companies V1 API
- Company searchSearch for a company by name or number
- Cache searchSearch for a company globally
- Lite ProfileBasic company verification details
- Enhanced ProfileCompany profiles with representatives and shareholders
- Filing searchOrder registry extracts and filings
- UBO VerifyFind the ultimate beneficial owners via corporate ownership structure
- About testingInformation about the Kyckr test environment
- Supported jurisdictionsJurisdictions and regional codes
- Response codesExtra information in the responseCodeField
- FAQsFrequently asked questions about the V1 API
Luxembourg Enhanced Profile – Shareholder Data Improvements
Overview
Luxembourg Enhanced Profiles now include much richer shareholder data. We've moved from the European Business Register (EBR) network to a direct integration with the Luxembourg Business Register (LBR).
Key improvements
Fully fielded shareholder data
Before, you only got shareholders listed as generic "Partner" references in the directors list with no ownership details. Now you get complete shareholding information:
- Share counts – Exact number of shares held by each shareholder
- Ownership percentages – Calculated ownership stakes for each shareholder
- Share class details – Complete information about different share classes (parts sociales)
- Shareholder addresses – Full addresses for corporate shareholders
Before (EBR integration)
Shareholders appeared only in the directors list with title "Partner":
{
"companyProfileField": {
"directorAndShareDetailsField": {
"directorsField": [
{
"nameField": "EXAMPLE HOLDINGS S.à r.l.",
"titleField": "Partner",
"address1Field": "123 Example Street",
"cityTownField": "Luxembourg",
"postcodeField": "1234",
"countryField": "Luxembourg"
},
{
"nameField": "EXAMPLE INVESTMENTS SAS",
"titleField": "Partner",
"address1Field": "456 Sample Road",
"cityTownField": "Paris",
"postcodeField": "75001",
"countryField": "France"
}
]
}
}
}After (LBR direct integration)
Shareholders now appear in the shareHoldersField array with complete ownership information:
{
"companyProfileField": {
"directorAndShareDetailsField": {
"shareHoldersField": [
{
"nameField": "EXAMPLE HOLDINGS S.à r.l.",
"addressField": "123, Example Street, Luxembourg, 1234, Luxembourg",
"shareholderTypeField": "Company",
"shareClassField": "parts sociales de classe A",
"shareTypeField": "parts sociales de classe A",
"shareCountField": 4249440000,
"percentageField": "42.49"
},
{
"nameField": "EXAMPLE INVESTMENTS SAS",
"addressField": "456, Sample Road, Paris, 75001, France",
"shareholderTypeField": "Company",
"shareClassField": "parts sociales de classe A",
"shareTypeField": "parts sociales de classe A",
"shareCountField": 5750560000,
"percentageField": "57.51"
}
]
}
}
}Multiple share classes
Many Luxembourg companies have multiple share classes. You'll see each shareholder's holdings in each class listed separately in the shareHoldersField array:
{
"shareHoldersField": [
{
"nameField": "EXAMPLE HOLDINGS S.à r.l.",
"shareClassField": "parts sociales de classe A",
"shareCountField": 4249440000,
"percentageField": "42.49"
},
{
"nameField": "EXAMPLE HOLDINGS S.à r.l.",
"shareClassField": "parts sociales de classe B",
"shareCountField": 4249440000,
"percentageField": "42.49"
},
{
"nameField": "EXAMPLE HOLDINGS S.à r.l.",
"shareClassField": "parts sociales de classe C",
"shareCountField": 4249440000,
"percentageField": "42.49"
}
]
}Ownership percentage calculation
The percentageField is calculated for each specific shareholding relative to all shareholdings across all share classes.
Important: We calculate the percentage by dividing the specific share count by the total shares across all classes. We assume all share classes have equal value per share when calculating percentages.
For example, if a company has three share classes (A, B, and C) with 10,000,000,000 shares each:
- Total shares across all classes: 30,000,000,000
- Shareholder 1's Class A shareholding: 4,249,440,000 shares
- Calculated percentage for this shareholding:
4,249,440,000 / 30,000,000,000 = 14.16%
The shareholder appears multiple times in the shareHoldersField array (once for each share class they hold), and each entry shows a different percentageField value - each representing that specific shareholding as a percentage of all shares across all classes.
Rich shareholder metadata
The LBR has exceptionally detailed shareholder data. We analyzed a sample of over 8,000 corporate shareholders from Luxembourg companies and found:
- Luxembourg shareholders: 100% include registration numbers
- Cayman Islands shareholders: 93% include registration numbers
- United States shareholders: 99% include registration numbers
- United Kingdom shareholders: 100% include registration numbers
You get registration numbers, registration authorities, and foreign legal forms for shareholders across 69 countries. This makes Luxembourg Enhanced Profiles great for ownership analysis and corporate structure investigations—you can trace shareholders across jurisdictions using reliable identifiers.
Future enhancement: We're working on normalizing country names and foreign registration authorities to include ISO country codes alongside registration numbers. This will make it easier to search for foreign shareholders across Kyckr's global network.
Shareholding data availability
Variable capital companies: Some Luxembourg companies have variable capital structures. For these companies, the shareHoldersField array may be empty.
Joint shareholders: In some cases, all shareholders hold shares jointly rather than individually. When this occurs, all the shareholders are listed but without specific share counts or percentages, as the exact distribution among joint shareholders is not documented at the registry.
Activity data now included
Enhanced Profiles for Luxembourg companies now include economic activity information using NACE classification codes:
{
"companyProfileField": {
"activityField": [
{
"codeField": "64.202",
"descriptionField": "Sociétés de participation financière (Soparfi)"
}
],
"activityDeclarationField": [
{
"declarationField": "La société a pour objet la prise de participations, sous quelque forme que ce soit...",
"declarationDescriptionField": "Objet social",
"languageField": "fr"
}
]
}
}This helps you quickly identify the company's business sector and classification.
The activityDeclarationField contains the full text of the company's business purpose (objet social) as stated in the Luxembourg Trade Register extract. The declarationField contains the complete French text describing what the company is authorized to do, while declarationDescriptionField indicates which section of the registry document it comes from (e.g., "Objet social" or "Purpose (Incomplete)" for truncated text).
Company status from observation codes
Luxembourg provides explicit status information through observation codes (O1-O20) in the registry data. We map these to normalized status values:
| Code | French | English | Normalized |
|---|---|---|---|
| (none) | – | Active | Active |
| O1 | avec administrateur provisoire | With provisional administrator | Distressed |
| O2 | en concordat obtenu par le failli | In composition obtained by the bankrupt | Distressed |
| O3 | en concordat préventif de la faillite | In preventive composition of bankruptcy | Distressed |
| O4 | en faillite | In bankruptcy | Distressed |
| O5 | en faillite clôturée | Bankruptcy closed | Inactive |
| O6 | en fermeture d'un établissement d'une société étrangère | Closing of a foreign company establishment | Inactive |
| O7 | en gestion contrôlée | In controlled management | Distressed |
| O8 | en liquidation judiciaire | In judicial liquidation | Distressed |
| O9 | en liquidation judiciaire clôturée | Judicial liquidation closed | Inactive |
| O10 | en Procédure d'insolvabilité (règl. CE 1346/2000) clôturée | Insolvency proceedings closed | Inactive |
| O11 | en Procédure d'insolvabilité (règl. CE 1346/2000) | In insolvency proceedings | Distressed |
| O12 | en Procédure judiciaire étrangère | In foreign judicial proceedings | Distressed |
| O13 | en Procédure judiciaire étrangère clôturée | Foreign judicial proceedings closed | Inactive |
| O14 | avec séquestre | With sequestrator | Distressed |
| O15 | en sursis de paiement | In payment suspension | Distressed |
| O16 | radiée | Struck off | Inactive |
| O17 | en liquidation volontaire | In voluntary liquidation | Distressed |
| O18 | en réorganisation judiciaire | In judicial reorganization | Distressed |
| O19 | en procédure de dissolution administrative sans liquidation | In administrative dissolution without liquidation | Inactive |
| O20 | en procédure de dissolution administrative sans liquidation arrêtée | Administrative dissolution without liquidation stopped | Inactive |
Sole traders
Sole traders are physical persons operating a business. The registration is for their trading name rather than a separate legal entity. In the response:
- The individual appears as a
Proprietorin thedirectorsFieldarray nameFieldat the company level contains the trading name, not a personal name
{
"companyProfileField": {
"registrationNumberField": "A12345",
"nameField": "Example Trading Name",
"legalFormField": "Individual Trader",
"legalFormDeclarationField": "Commerçant personne physique",
"directorAndShareDetailsField": {
"directorsField": [
{
"titleField": "Proprietor",
"nameField": "John Smith",
"nationalityField": "Luxembourgish",
"address1Field": "123 Example Street",
"cityTownField": "Luxembourg",
"postcodeField": "1234"
}
]
}
}
}Additional changes
Director changes
Role terminology
Director roles now use French terminology from the LBR:
Changes:
"Administrator / Manager"→"Administrateur - Gérant"or"Gérant"(Manager)"Everyday management responsible"→ Now appears as"Délégué à la gestion journalière"delegate roles"Partner"→ Removed from directors list (now in shareholders)
Appointment dates now included
Directors now include appointedOnField with actual appointment dates:
Note: The birthdateField and nationalityField are no longer provided in the LBR integration. The LBR focuses on corporate governance data rather than personal data.
Corporate directors
Corporate directors (companies acting as managers) now include their registration number:
{
"titleField": "Gérant",
"directorNumberField": "B123456",
"appointedOnField": "2023-09-01"
}Address structure improvements
Addresses now have a simpler, cleaner structure:
Before:
{
"addressesField": [
{
"countryField": "Luxembourg",
"lineField": [
{
"lineField": "123 Example Street",
"typeField": "",
"typeCodeField": ""
},
{
"lineField": "1234",
"typeField": "",
"typeCodeField": ""
},
{
"lineField": "Luxembourg",
"typeField": "",
"typeCodeField": ""
}
],
"typeField": "Address of the local main office",
"addressInOneLineField": "123 Example Street, Luxembourg, 1234, Luxembourg",
"addressLine1Field": "123 Example Street",
"cityTownField": "Luxembourg",
"postcodeField": "1234"
}
]
}After:
{
"addressesField": [
{
"addressInOneLineField": "123, Example Street, 1234 Luxembourg",
"addressLine1Field": "123 Example Street",
"cityTownField": "Luxembourg",
"postcodeField": "1234"
}
]
}Legal form normalization
French legal forms are now normalized to English AML-relevant entity types. The response includes both the normalized form and the original declaration:
| French (original) | English (normalized) |
|---|---|
| Société anonyme | Public Limited Company |
| Société à responsabilité limitée | Private Limited Company |
| Société à responsabilité limitée simplifiée | Private Limited Company |
| Société par actions simplifiée | Simplified Joint Stock Company |
| Société européenne | European Company |
| Société en commandite par actions | Partnership Limited by Shares |
| Société en commandite simple | Limited Partnership |
| Société en nom collectif | General Partnership |
| Société civile | Civil Partnership |
| Société coopérative | Cooperative |
| Société d'investissement à capital variable | Investment Fund |
| Fonds commun de placement | Investment Fund |
| Association sans but lucratif | Non-Profit Association |
| Commerçant personne physique | Individual Trader |
| Succursale d'une personne morale de droit étranger | Foreign Branch |
| Fondation | Foundation |
| Groupement d'intérêt économique | Economic Interest Group |
| Mutuelle | Mutual Society |
Before:
{
"legalFormField": "Société d'investissement à capital variable"
}After:
{
"legalFormField": "Investment Fund",
"legalFormDeclarationField": "Société d'investissement à capital variable"
}The legalFormField contains the normalized English legal form, while legalFormDeclarationField preserves the original French terminology from the registry.