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
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). You’ll get structured data directly from the LBR’s French Trade Registry Extract (Extrait du registre de commerce français), with more detail and better structure for Luxembourg companies.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”:After (LBR direct integration)
Shareholders now appear in theshareHoldersField array with complete ownership information:
Multiple share classes
Many Luxembourg companies have multiple share classes. You’ll see each shareholder’s holdings in each class listed separately in theshareHoldersField array:
Ownership percentage calculation
ThepercentageField 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 shares each:
- Total shares across all classes: 30,000,000
- Shareholder 1’s Class A shareholding: 4,249,440 shares
- Calculated percentage for this shareholding:
4,249,440 / 30,000,000 = 14.16%
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
Shareholding data availability
Variable capital companies: Some Luxembourg companies have variable capital structures. For these companies, theshareHoldersField 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: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”).
Company status derivation
Important: The Luxembourg Business Register doesn’t provide an explicit company status field in their extracts. We derive the status by analyzing negative information in the registry documents:- active – Default status when no negative indicators are present (96% of companies)
- distressed – Bankruptcy declaration (faillite) information is present in the extract
- in_liquidation – Voluntary liquidation information is present in the extract
- deregistered – The document is a deregistration certificate
legalStatusField represents our interpretation of the company’s state based on structured data from the French Trade Registry Extract (Extrait du registre de commerce français).
Example:
Additional changes
Director role terminology
Director roles now use French terminology from the LBR: Changes:"Administrator / Manager"→"Gérant"(Manager)"Everyday management responsible"→"Gérant délégué à la gestion journalière"(Delegate manager for daily management)"Partner"→ Removed from directors list (now in shareholders)