registercheckby openlaw group
API referencePersons

List the roles a person holds

GET
/persons/{person_id}/roles

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

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

In: header

Path Parameters

person_id*string

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.

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

Query Parameters

role_type?array<>

Only roles of one of these types (role.type). Repeat the parameter for several.

limit?integer

Page size, 1 to 100.

Range1 <= value <= 100
Default20
cursor?string

The 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.

Length1 <= length <= 2000

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

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