---
title: "Get historical owner changes"
method: GET
path: "/v1/company/{company_id}/owners/historical"
tags: ["v1"]
---

# Get historical owner changes

`GET /v1/company/{company_id}/owners/historical`

## Request

- Base URL: `https://api.openregister.de`
- URL: `https://api.openregister.de/v1/company/{company_id}/owners/historical`
- Auth: HTTP bearer

## Path parameters

- `company_id` string, required

## Response `200`

Successfully retrieved historical owner changes

- HistoricalOwnersResponse
  - `owners` OwnerHistory[], required
    - `id` string, required: Unique identifier for the owner. For companies, this is the company register ID (e.g. DE-HRB-F1103-267645) which can be used to look up the company. For natural persons, this is the entity UUID. For other entity types (foreign companies, foundations, etc.), this is empty.
    - `name` string, required: Name of the owner
    - `entity_type` 'natural_person' | 'german_company' | 'foreign_company' | 'german_government_entity' | 'german_foundation' | 'german_multiple_shareholder', required: Type of the owner entity
    - `country` string: Country of the owner
    - `ownership_history` OwnershipEntry[], required: Historical ownership data across all documents
      - `document_id` string, uuid, required: Document where this ownership data was found
      - `document_date` string, date-time, required: Date of the document
      - `nominal_shares` integer, required: Nominal value of shares in this document
      - `percentage_shares` number, double, required: Percentage ownership in this document
    - `first_appearance` string, date-time, required: Date when this owner first appeared
    - `last_appearance` string, date-time: Date when this owner last appeared (null if still active)
    - `status` 'active' | 'removed', required: Current status of the owner

## Other responses

- `202`: Accepted - Historical owners are being processed, retry this request shortly
- `400`: Bad Request - Invalid parameters provided
- `401`: Unauthorized - Authentication required
- `402`: Payment Required - Insufficient credits for this request
- `404`: Not Found - Company ID doesn't exist or has no owner history
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - An error occurred while processing the request

## Changes

- **2026-03-12** `3e550ef1f751`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/oregister/apis/openregister-api/changes/v1/company/:company_id/owners/historical/get.md)

---

[API](https://skmtc.dev/oregister/apis/openregister-api.md) - [All operations](https://skmtc.dev/oregister/apis/openregister-api/llms.txt) - [OpenAPI document](https://skmtc.dev/oregister/apis/openregister-api/revisions/d1fcaf6d6ca0?raw)