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

# Get person holdings

`GET /v1/person/{person_id}/holdings`

## Request

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

## Path parameters

- `person_id` string, uuid, required

## Response `200`

The holdings of the person

- PersonHoldings: Companies this entity owns or has invested in.
  - `person_id` string, required: Unique person identifier. Example: cc78ab54-d958-49b8-bae7-2f6c0c308837
  - `holdings` PersonHoldingItem[], required: Shareholder and limited partner positions of the person.
    - `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`: 1 info
  - endpoint added

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