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

# Get company shareholders

`GET /v0/company/{company_id}/shareholders`

## Request

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

## Path parameters

- `company_id` string, required

## Response `200`

Successfully retrieved shareholders

- CompanyShareholders
  - `document_id` string, required: Unique identifier for the document this was taken from. Example: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  - `date` string, date, required: Date when this shareholder information became effective. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
  - `shareholders` CompanyShareholder[], required
    - `id` string: Unique identifier for the shareholder. For companies: Format matches company_id pattern For individuals: UUID Example: "DE-HRB-F1103-267645" or UUID May be null for certain shareholders.
    - `type` 'natural_person' | 'legal_person', required
    - `name` string, required: The name of the shareholder. E.g. "Max Mustermann" or "Max Mustermann GmbH"
    - `nominal_share` integer, required: Nominal value of shares in Euro. Example: 100
    - `percentage_share` number, double, required: Percentage of company ownership. Example: 5.36 represents 5.36% ownership
    - `country` string, required: Country where the shareholder is located, in ISO 3166-1 alpha-2 format. Example: "DE" for Germany

## Other responses

- `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
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - An error occurred while processing the request

## Changes

- **2026-03-10** `fa42933e6446`: 1 info
  - endpoint added
- **2025-11-25** `51c52538f534`: 1 breaking
  - api path removed without deprecation
- **2025-08-27** `b37d87e51e02`: 1 info
  - api tag `v0` added

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