List the companies a person holds interests in
Shareholdings in which this person is the holder: shares in a GmbH or UG
(shareholder), a Kommanditist's interest (limited_partner) and a Komplementär's
(general_partner), each with the company it is in. A holding has the same id as the
same interest on GET /companies/{company_id}/shareholders. Read here, its holder is
this person, linked; on the company's list it is the holder as the filing names it,
whose holder.id can be null. The most confident matches come first.
A Komplementär both represents the KG and holds an interest in it, so they also
have a general_partner role at GET /persons/{person_id}/roles. The interest is
listed for as long as that role is current, and it is the shareholding the KG's own
GET /companies/{company_id}/shareholders lists for them.
Costs 10 credits.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_prod_….
In: header
Path Parameters
The person's id (per_…). 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 person_id.
^per_[0-7][0-9a-hjkmnp-tv-z]{25}$Query Parameters
Page size, 1 to 100.
1 <= value <= 10020The next_cursor of the previous page; leave it out for the first page. Opaque: pass it
back as it came. A cursor from another list, or from the same list with other filters,
answers 400 validation_failed naming cursor.
1 <= length <= 2000Response 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
curl -X GET "https://api.registercheck.de/v1/persons/per_01hxn3rys1fh58w4d1pb1x9s82/holdings" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY"{ "object": "page", "next_cursor": null, "extract": null, "data": [ { "id": "shr_1b7h6nwvvt9e69t3gz58xmrqbe", "object": "shareholding", "company": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "name": "Beispiel Reisen GmbH" }, "holder": { "object": "person", "id": "per_01hxn3rys1fh58w4d1pb1x9s82", "name": "Erika Mustermann" }, "holder_as_filed": { "type": "person", "name": { "full": "Erika Mustermann", "first": null, "last": null, "birth_name": null, "titles": [] }, "birth_date": null, "city": null, "country": null, "person": { "object": "person", "id": "018f6a3c-7b21-7c4a-8e11-a1b2c3d4e502", "name": "Erika Mustermann" }, "match_confidence": null }, "type": "shareholder", "percentage": 60, "nominal_amount": { "amount": "15000.00", "currency": "EUR" }, "liability_amount": null, "match_confidence": 0.95, "source": { "object": "document", "id": "doc_3cfp79y2gv9gprwftabdp7v3mz", "date": "2024-06-01", "type": "shareholder_list" } } ]}