---
title: "Add a shareholder to a business"
method: POST
path: "/v1/customers/businesses/{customer_id}/shareholders"
tags: ["Customers"]
deprecated: true
---

# Add a shareholder to a business

`POST /v1/customers/businesses/{customer_id}/shareholders`

> **Deprecated.**

Add a shareholder to a business

## Path parameters

- `customer_id` string, Uuid, required

## Request body

- union
  - object — Company 1 |--> Shareholder 1 (Business) | |--> Shareholder 3 (Individual) |--> Shareholder 2 (Business) | |--> Shareholder 4 (Business) |--> Shareholder 5 (Individual)
    - `shareholder` object, required
      - `dob` string, date, required
      - `first_name` string, string, required
      - `id_number` string, string, required
      - `id_type` 'passport' | 'national_id', required
      - `last_name` string, string, required
      - `middle_name` string, string, nullable
      - `pob` string, string, required
    - `holding_percentage` integer, required
    - `shareholder_of` string, Uuid, nullable
  - object — Company 1 |--> Shareholder 1 (Business) | |--> Shareholder 3 (Individual) |--> Shareholder 2 (Business) | |--> Shareholder 4 (Business) |--> Shareholder 5 (Individual)
    - `business_shareholder` object, required
      - `name` string, string, required
      - `registration_number` string, string, required
    - `holding_percentage` integer, required
    - `shareholder_of` string, Uuid, nullable

## Response `201`

Business has been created successfully

- AddShareholderResponse
  - `id` string, Uuid, required

## Other responses

- `400` — Invalid request
- `401` — Authentication error
- `500` — Internal server error

---

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