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

# Get company shareholders

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

## 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

---

[API](https://skmtc.net/oregister/apis/openregister-api.md) · [All operations](https://skmtc.net/oregister/apis/openregister-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oregister/openregister-api/revisions/d1fcaf6d6ca0/schema)