Skip to main content
GET
/
v1
/
company
/
{company_id}
/
owners
/
historical
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.getHistoricalOwnersV1('company_id');

console.log(response.owners);
{
  "owners": [
    {
      "id": "<string>",
      "name": "<string>",
      "entity_type": "natural_person",
      "ownership_history": [
        {
          "document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "document_date": "2023-11-07T05:31:56Z",
          "nominal_shares": 123,
          "percentage_shares": 123
        }
      ],
      "first_appearance": "2023-11-07T05:31:56Z",
      "status": "active",
      "country": "<string>",
      "last_appearance": "2023-11-07T05:31:56Z"
    }
  ]
}

Retrieve the historical ownership changes of a company

Get the full ownership history of a company across all filed documents. Unlike the current owners endpoint, this endpoint returns ownership data from every shareholder list (Gesellschafterliste) ever filed, allowing you to trace how ownership has changed over time. Cost: 25 credits

Async Processing

This endpoint may need to process data before it can return a result. Depending on the state of the data, you will receive one of two responses:
StatusMeaning
200 OKData is ready — the response body contains the full ownership history.
202 AcceptedProcessing is still in progress. Re-call the same endpoint until you receive a 200.
When you receive a 202, wait 30 seconds before retrying. Re-call the same endpoint with the same company_id. There is no separate job ID — simply poll until you get a 200.202 responses are not billed. Credits are only deducted when the endpoint returns 200 with data.
Historical ownership data is available for:
  • GmbH (Gesellschaft mit beschränkter Haftung) - Limited liability company

Ownership Data Structure

The response includes ownership snapshots across all filed documents. Each snapshot contains the document date, the owners at that point in time, their ownership stake (as percentage and/or nominal shares), and share capital. For corporate shareholders, you’ll receive the company ID to retrieve further details.

Use Cases

Ownership Analysis: Understand who has controlled a company over time and identify indirect ownership through corporate shareholders. Map ownership chains to reveal corporate structures. Funding Rounds: Analyze funding rounds and understand who invested when — trace new shareholders entering the cap table and stake changes over time to reconstruct the company’s funding history. Risk Assessment: Identify concentration of ownership, related party transactions, or complex ownership structures that may require additional scrutiny. Network Mapping: Track ownership connections between companies over time to identify business groups, family holdings, or corporate networks.

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

Successfully retrieved historical owner changes

owners
object[]
required