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

Costs 10 credits.

Authorization

bearerAuth
AuthorizationBearer <token>

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

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

curl -X GET "https://api.registercheck.de/v1/companies/cmp_1z3gn9wpvx9j59w8bd9w5rm72n/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"  }}