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

# Get person holdings

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

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

---

[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)