GET
/
v0
/
company
/
{company_id}
/
shareholders
JavaScript
import Openregister from 'openregister';

const client = new Openregister({
  apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted
});

const response = await client.company.listShareholders('company_id');

console.log(response.document_id);
{
  "document_id": "<string>",
  "date": "<string>",
  "shareholders": [
    {
      "id": "<string>",
      "type": "natural_person",
      "name": "<string>",
      "nominal_share": 123,
      "percentage_share": 123,
      "country": "<string>"
    }
  ]
}

​
Retrieve the shareholders of a company

This endpoint currently only supports companies with the legal form GmbH. But we are actively working on supporting other legal forms.

The endpoint may process the files from the register in real-time. The request can take up to 30 seconds to complete. In practice, it should take less than 2 seconds.

Authorizations

​
Authorization
string
header
required

API Key Authentication Provide your API key as a Bearer token in the Authorization header.

Path Parameters

​
company_id
string
required

Unique company identifier. Example: DE-HRB-F1103-267645

Response

200
application/json

Successfully retrieved shareholders

The response is of type object.