---
title: "Get company holdings"
method: GET
path: "/v1/company/{company_id}/holdings"
tags: ["v1"]
---

# Get company holdings

`GET /v1/company/{company_id}/holdings`

## Request

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

## Path parameters

- `company_id` string, required

## Response `200`

The holdings of the company

- CompanyHoldings: Companies this entity owns or has invested in.
  - `company_id` string, required: Unique company identifier. Example: DE-HRB-F1103-267645
  - `holdings` CompanyHoldingItem[], required
    - `company_id` string, required: Unique company identifier. Example: DE-HRB-F1103-267645
    - `relation_type` 'shareholder' | 'stockholder' | 'limited_partner' | 'general_partner', required
    - `name` string, required: Name of the company.
    - `nominal_share` number, double, required: Amount of shares or capital in the company. Example: 100
    - `percentage_share` number, double, nullable, required: Share of the company. Example: 0.5 represents 50% ownership
    - `start` string, date, nullable, required: Date when the ownership started. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
    - `end` string, date, nullable, required: Date when the ownership ended. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"

## Other responses

- `400`: Bad Request - Invalid parameters provided
- `401`: Unauthorized - Authentication required
- `402`: Payment Required - Insufficient credits for this request
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - An error occurred while processing the request

## Changes

- **2025-08-27** `b37d87e51e02`: 3 breaking, 4 info
  - the response property `holdings/items/end` became nullable for the status `200`
  - the response property `holdings/items/percentage_share` became nullable for the status `200`
  - the response property `holdings/items/start` became nullable for the status `200`
  - api tag `v1` added
  - …3 more
- **2025-08-07** `174349fff670`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/oregister/apis/openregister-api/changes/v1/company/:company_id/holdings/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)