List the roles a person holds
The offices a person holds or held, each with the company it is at: managing
director, board member, general partner, liquidator, authorised signatory
(Prokurist). The same role object GET /companies/{company_id}/roles lists for
that company, under the same id, with match_confidence saying how sure we are
that the register entry names this person. Current roles come first, then the
most confident matches.
The interests a person holds in companies are shareholdings:
GET /persons/{person_id}/holdings.
Costs 10 credits. The first page is free with GET /persons/{person_id}?expand=roles.
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
Only roles of one of these types (role.type). Repeat the parameter for several.
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/roles" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY"{ "object": "page", "next_cursor": null, "extract": null, "data": [ { "id": "rol_4b1sy1tbst9de8v7ga3cp3tkjz", "object": "role", "type": "managing_director", "type_as_registered": "Geschäftsführerin", "status": "current", "appointed_date": "2010-01-15", "ended_date": null, "company": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "name": "Beispiel Reisen GmbH" }, "holder": { "object": "person", "id": "per_01hxn3rys1fh58w4d1pb1x9s82", "name": "Erika Mustermann" }, "holder_as_registered": { "name": { "full": "Erika Mustermann", "first": "Erika", "last": "Mustermann", "birth_name": null, "titles": [] }, "birth_date": "1970-01-01", "city": "Musterstadt" }, "signing_authority": { "type": "sole", "basis": "entry", "self_dealing_exempt": null, "real_estate_power": null, "limited_to_branch": null, "text": "Einzelvertretungsberechtigt", "together_with": null }, "match_confidence": 0.95 } ]}