List who holds an interest in a company
Shareholders from the most recent shareholder list on file, and the general and
limited partners of a partnership. With depth greater than 1, the owners of
corporate owners are included, each linked to its parent by
parent_shareholding_id, with the resulting effective_percentage.
availability says whether an empty list means "no owners on file" or "not
extracted yet".
If we hold no shareholder list for this company yet, asking for one starts
the work: the response says availability: processing, and the same request
a little later returns the owners. One call starts at most one extraction,
for the company you asked about — depth does not multiply it.
Costs 10 credits.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_live_….
In: header
Path Parameters
The company's id.
uuidQuery Parameters
How many ownership levels to resolve.
1 <= value <= 31Page size.
1 <= value <= 10020Return the page after the object with this id. Cannot be combined with ending_before.
uuidResponse Body
application/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://example.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/shareholders"{ "object": "list", "has_more": false, "url": "/v1/companies/3f1c2a9e-5b7d-4c8a-9e21-6d4f0b8a1c55/shareholders", "availability": "available", "data": [ { "object": "ownership_entry", "depth": 1, "effective_percentage": 60, "via_shareholding_id": null, "shareholding": { "id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e", "object": "shareholding", "company": { "object": "company", "id": "3f1c2a9e-5b7d-4c8a-9e21-6d4f0b8a1c55", "name": "Beispiel Analytics GmbH" }, "owner": { "type": "person", "name": { "full": "Dr. Erika Mustermann", "first": "Erika", "last": "Mustermann", "birth_name": null, "titles": [ "Dr." ] }, "birth_date": "1980-05-21", "city": "München", "country": "DE", "person": { "object": "person", "id": "5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d", "name": "Erika Mustermann" }, "match_confidence": 0.97 }, "interest": "shareholder", "percentage": 60, "nominal_amount": { "amount": "15000.00", "currency": "EUR" }, "liability_amount": null, "source": { "kind": "shareholder_list", "document_id": "6c7d8e9f-0a1b-4c2d-8e3f-4a5b6c7d8e9f", "document_date": "2025-06-03" } } }, { "object": "ownership_entry", "depth": 1, "effective_percentage": 40, "via_shareholding_id": null, "shareholding": { "id": "3c4d5e6f-7a8b-4c9d-8e0f-2a3b4c5d6e7f", "object": "shareholding", "company": { "object": "company", "id": "3f1c2a9e-5b7d-4c8a-9e21-6d4f0b8a1c55", "name": "Beispiel Analytics GmbH" }, "owner": { "type": "company", "name": "Beispiel Beteiligungs GmbH", "register": { "court": { "code": "D2601", "name": "Amtsgericht München" }, "type": "HRB", "number": "288888", "display": "Amtsgericht München HRB 288888", "country": "DE" }, "city": "München", "country": "DE", "company": { "object": "company", "id": "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f", "name": "Beispiel Beteiligungs GmbH" } }, "interest": "shareholder", "percentage": 40, "nominal_amount": { "amount": "10000.00", "currency": "EUR" }, "liability_amount": null, "source": { "kind": "shareholder_list", "document_id": "6c7d8e9f-0a1b-4c2d-8e3f-4a5b6c7d8e9f", "document_date": "2025-06-03" } } } ]}