Major shareholding notifications API
When a fund or company crosses 3, 5 or 10% of a listed issuer's voting rights, it files a notification: a TR-1 in the UK, a franchissement de seuil in France, a Beteiligungsmeldung in Austria. Duceus reads these filings from 7 European registers and serves them in one schema, with each holder matched to its LEI and parent group.
What a notification contains
| Holder | holder_name, holder_type, holder_lei, holder_ultimate_parent_lei / _name |
| Stake | new_pct_voting, new_pct_capital, prev_pct_voting, new_voting_rights_count |
| Crossing | threshold_crossed_pct, threshold_direction, event_type, reason_raw |
| Dates | event_date, notification_date, published_at, is_late |
| Instruments | positions[]: shares, options, swaps, lent stock; LONG or SHORT |
| Chain | parties[]: obliged holder, controlled undertakings, beneficial owners, concert members |
| Source | source_name, source_reference, source_url, supersedes_reference |
Every field, with types, is in the documentation.
Coverage
| Country | Notifications stored | Since |
|---|---|---|
| Austria | 2,252 | 2016 |
| Switzerland | 17,748 | 2016 |
| Denmark | 28 | 2024 |
| Finland | 2,190 | 2016 |
| France | 7,544 | 2021 |
| United Kingdom | 82,373 | 2017 |
| Netherlands | 1,156 | 2016 |
Managers' transactions cover more countries; see coverage.
Endpoints
GET /holdings: Every notification, filterable by country, issuer, holder, LEI, parent LEI or ISIN.GET /threshold-events: Only actual crossings, above or below, with a minimum stake filter.GET /issuers/{id}/shareholders: A derived cap table: each holder's latest stake in the issuer, largest first.GET /issuers/{id}/shareholder-groups: The same holders grouped under their ultimate parent.GET /holders/{id}: One holder with its latest stake in each issuer.
New stakes of 5% or more
curl "https://api.duceusapi.com/threshold-events?direction=ABOVE&min_pct=5&limit=50" \
-H "Authorization: Bearer YOUR_API_KEY"Every BlackRock entity, in one filter
curl "https://api.duceusapi.com/holdings?ultimate_parent_lei=529900VBK42Y5HHRMD23&limit=50" \
-H "Authorization: Bearer YOUR_API_KEY"Webhooks push each new notification as it is stored.
Questions
Are the thresholds the same in every country?
No. The Directive sets a minimum, and many states add lower or intermediate thresholds: 3% in the United Kingdom, Germany and the Netherlands, among others. Switzerland, outside the Directive, starts at 3% under its own law. The API returns the threshold each filing states in threshold_crossed_pct.
How fast is a threshold crossing published?
Under the Directive the holder notifies the issuer within four trading days and the issuer publishes within three more (Article 12). Several states set shorter deadlines. The API keeps event_date, notification_date and published_at apart, and flags filings the source marks as late in is_late.
Do the notifications include derivatives and short positions?
Yes, when the filing states them. Each notification carries one position per instrument line: shares held directly or indirectly, options, swaps, lent stock. Short positions come with direction SHORT and new_pct_voting_short.
How do I see every holding of a group like BlackRock?
Holders are matched to their Legal Entity Identifier and to the ultimate parent GLEIF records for it. Filter /holdings by ultimate_parent_lei, or read /issuers/{id}/shareholder-groups, to group the dozens of entities that file under one parent.
Does the API show the ownership chain behind a holding?
Yes. The first party of a notification is the holder obliged to notify; further parties are the controlled undertakings, beneficial owners or members acting in concert the filing names, each with its own percentages.
What about corrected notifications?
A correction is a new filing that names the one it corrects in supersedes_reference. Both stay available, so you can see what was filed and when.
Managers' transactions under MAR Article 19 are answered in the FAQ.