registercheckby openlaw group
API referenceCompanies

List the companies a company holds interests in

GET
/companies/{company_id}/holdings

Shareholdings in which this company is the holder: the shares it holds in other companies as a shareholder, each under the id the held company's GET /companies/{company_id}/shareholders gives the same interest. An interest the held company's current list no longer names (a stake sold since) is not listed, and a general partner's interest is not listed here.

Costs 10 credits.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

company_id*string

The company's id (cmp_…). 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 company_id.

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

Query Parameters

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

application/problem+json

curl -X GET "https://api.registercheck.de/v1/companies/cmp_01hxn3rys1fh58w4d1pb1x9s81/holdings" \  -H "Authorization: Bearer $REGISTERCHECK_API_KEY"
{  "object": "page",  "next_cursor": null,  "extract": null,  "data": [    {      "id": "shr_3ydne4pehf9resr2wafxq5tk1v",      "object": "shareholding",      "company": {        "object": "company",        "id": "cmp_01hxn3rys1fh58w4d1pb1x9s85",        "name": "Beispiel Festival GmbH"      },      "holder": {        "object": "company",        "id": "cmp_01hxn3rys1fh58w4d1pb1x9s81",        "name": "Beispiel Reisen GmbH"      },      "holder_as_filed": {        "type": "company",        "name": "Beispiel Reisen GmbH",        "register": null,        "city": null,        "country": null,        "company": {          "object": "company",          "id": "018f6a3c-7b21-7c4a-8e11-a1b2c3d4e501",          "name": "Beispiel Reisen GmbH"        }      },      "type": "shareholder",      "percentage": 100,      "nominal_amount": {        "amount": "25000.00",        "currency": "EUR"      },      "liability_amount": null,      "match_confidence": null,      "source": {        "object": "document",        "id": null,        "date": null,        "type": null      }    }  ]}