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

# Get company owners

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

## Path parameters

- `company_id` string, required

## Query parameters

- `realtime` boolean
- `export` boolean
- `best_available` boolean

## Response `200`

The owners of the company

- CompanyOwners
  - `company_id` string, required — Unique company identifier. Example: DE-HRB-F1103-267645
  - `owners` CompanyOwnerItem[], required
    - `id` string, nullable, required — 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
    - `relation_type` 'shareholder' | 'stockholder' | 'limited_partner' | 'general_partner', required
    - `name` string, required — The name of the shareholder. E.g. "Max Mustermann" or "Max Mustermann GmbH"
    - `natural_person` CompanyOwnerNaturalPerson, nullable, required
      - `full_name` string, required
      - `first_name` string, required
      - `last_name` string, required
      - `date_of_birth` string, nullable, required
      - `city` string, required
      - `country` string, required
    - `legal_person` CompanyOwnerLegalPerson, nullable, required
      - `name` string, required
      - `city` string, nullable, required
      - `country` string, required — Country where the owner is located, in ISO 3166-1 alpha-2 format. Example: "DE" for Germany
    - `nominal_share` number, double, required — Nominal value of shares in Euro. Example: 100
    - `percentage_share` number, double, nullable, required — Percentage of company ownership. Example: 5.36 represents 5.36% ownership
    - `start` string, date, nullable, required — Date when the relation started. Only available for some types of owners. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
  - `sources` Source[], required — Sources of the company owners data.
    - `document_url` string, required — Url of the source document. In the form of a presigned url accessible for 30 minutes.
  - `best_available` boolean, required — When true, the returned owner data is the best available but may not reflect the most current ownership state. This applies to AG and SE companies where ownership data is sourced from Handelsregister decision and articles of association documents, which are not filed on every ownership change.

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

---

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