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_live_….
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
curl -X GET "https://api.registercheck.de/v1/persons/per_2tddy8v7gf98drrb9y9xd6pz4d/holdings" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY"{ "object": "page", "next_cursor": "string", "data": [ { "id": "shr_1b7h6nwvvt9e69t3gz58xmrqbe", "object": "shareholding", "company": { "object": "company", "id": "cmp_1z3gn9wpvx9j59w8bd9w5rm72n", "name": "string" }, "holder": { "object": "company", "id": "cmp_1z3gn9wpvx9j59w8bd9w5rm72n", "name": "string" }, "type": "shareholder", "percentage": 0, "nominal_amount": { "amount": "25000.00", "currency": "EUR" }, "liability_amount": { "amount": "25000.00", "currency": "EUR" }, "match_confidence": 0, "source": { "object": "document", "id": "doc_3cfp79y2gv9gprwftabdp7v3mz", "date": "2019-08-24", "type": "shareholder_list" } } ], "extract": { "status": "parsed", "fetched_at": "2019-08-24T14:15:22Z", "document_id": "doc_3cfp79y2gv9gprwftabdp7v3mz" }}