registercheckby openlaw group
API referenceCompanies

Retrieve the tree of a company's holders

GET
/companies/{company_id}/ownership-tree

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
AuthorizationBearer <token>

Your API key, sent as Authorization: Bearer rc_prod_….

In: header

Path Parameters

company_id*string

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.

Match^cmp_[0-7][0-9a-hjkmnp-tv-z]{25}$

Query Parameters

depth?integer

How many ownership levels to resolve.

Range1 <= value <= 3
Default1

Response 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}