Retrieve the tree of a company's holders
The holders of this company as a tree: one node per shareholding on each path that
reaches it, saying where it sits. depth is how many levels to resolve, from 1 to 3. effective_percentage is
the share of the company you asked about. At depth 1 it equals the holding's own
percentage. Further down it is the product of the percentages along the path,
rounded half up to four decimal places, or null when a percentage on that path is
missing or cannot be published.
via_shareholding_id is the holding one level down. The shareholding in a node is
the object GET /companies/{company_id}/shareholders lists, unchanged by how it was
reached.
Asking starts at most one shareholder extraction, for the company you asked about. Every company further up is read from ownership already stored, and does not start one. A company or a person with a Sperrung is left out at every level, the same way as on the shareholder list. When that check cannot be made, the answer is a failure and nothing is charged.
A holding is not followed when following it would close a cycle (cycle), when the
company holds itself (self_holding), when the holder is an AG, SE or KGaA, when
the holder is a company we have not linked, or when depth is reached. unresolved
names each of those holdings and why (cycle, self_holding, stock_corporation,
foreign_entity, entity_not_linked, depth_limit, no_shareholder_list,
extraction_pending), and every holding whose percentage is missing
(percentage_withheld), which is still followed. complete is true when unresolved is
empty, the walk was not cut short, and list_reason is null. truncated is true when
the depth you asked for, or the cap of 250 nodes, stopped it; truncated_reason says
which, and the cap wins when both apply.
An empty nodes does not by itself say whether no shareholder list is on file or
whether it is not extracted yet. list_reason is no_shareholder_list or
extraction_pending when that list is missing or still being read, including when
general or limited partners are listed, and complete is false.
GET /companies/{company_id}/shareholders still says which (extract.status).
As there, asking starts the extraction when we hold no shareholder list for the
company yet: at most one, for the company you asked about.
Costs 10 credits.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_prod_….
In: header
Path Parameters
The company's id (cmp_…). The raw UUID /v1 published before is still read until 2026-12-31,
and such a request is answered with Deprecation and Sunset. An id of another kind, or
anything else, answers 400 validation_failed naming company_id.
^cmp_[0-7][0-9a-hjkmnp-tv-z]{25}$Query Parameters
How many ownership levels to resolve.
1 <= value <= 31Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://api.registercheck.de/v1/companies/cmp_01hxn3rys1fh58w4d1pb1x9s81/ownership-tree?depth=2" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY"{ "object": "ownership_tree", "company": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "name": "Beispiel Reisen GmbH" }, "nodes": [ { "shareholding": { "id": "shr_1b7h6nwvvt9e69t3gz58xmrqbe", "object": "shareholding", "company": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "name": "Beispiel Reisen GmbH" }, "holder": { "object": "person", "id": null, "name": "Erika Mustermann" }, "holder_as_filed": { "type": "person", "name": { "full": "Erika Mustermann", "first": null, "last": null, "birth_name": null, "titles": [] }, "birth_date": "1970-01-01", "city": null, "country": null, "person": null, "match_confidence": null }, "type": "shareholder", "percentage": 60, "nominal_amount": { "amount": "15000.00", "currency": "EUR" }, "liability_amount": null, "match_confidence": null, "source": { "object": "document", "id": "doc_3cfp79y2gv9gprwftabdp7v3mz", "date": "2024-06-01", "type": "shareholder_list" } }, "depth": 1, "effective_percentage": 60, "via_shareholding_id": null, "cycle": false, "self_holding": false }, { "shareholding": { "id": "shr_1w9nf6yymb9jerw3sa7d65tvkz", "object": "shareholding", "company": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "name": "Beispiel Reisen GmbH" }, "holder": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s84", "name": "Muster Holding GmbH" }, "holder_as_filed": { "type": "company", "name": "Muster Holding GmbH", "register": null, "city": null, "country": null, "company": { "object": "company", "id": "018f6a3c-7b21-7c4a-8e11-a1b2c3d4e504", "name": "Muster Holding GmbH" } }, "type": "shareholder", "percentage": 40, "nominal_amount": { "amount": "10000.00", "currency": "EUR" }, "liability_amount": null, "match_confidence": null, "source": { "object": "document", "id": "doc_3cfp79y2gv9gprwftabdp7v3mz", "date": "2024-06-01", "type": "shareholder_list" } }, "depth": 1, "effective_percentage": 40, "via_shareholding_id": null, "cycle": false, "self_holding": false }, { "shareholding": { "id": "shr_60zzq0048h88h86ct4ank7f24s", "object": "shareholding", "company": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s84", "name": "Muster Holding GmbH" }, "holder": { "object": "person", "id": null, "name": "Lena Beispiel" }, "holder_as_filed": { "type": "person", "name": { "full": "Lena Beispiel", "first": null, "last": null, "birth_name": null, "titles": [] }, "birth_date": "1984-11-03", "city": null, "country": null, "person": null, "match_confidence": null }, "type": "shareholder", "percentage": 50, "nominal_amount": null, "liability_amount": null, "match_confidence": null, "source": { "object": "document", "id": "doc_2y1x5hwyjc9e79tbrt5cy4tqkf", "date": "2025-06-03", "type": "shareholder_list" } }, "depth": 2, "effective_percentage": 20, "via_shareholding_id": "shr_1w9nf6yymb9jerw3sa7d65tvkz", "cycle": false, "self_holding": false } ], "complete": true, "truncated": false, "truncated_reason": null, "unresolved": [], "list_reason": null}