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

## Request

- Base URL: `https://auth-sandbox.fuse.me`
- URL: `https://auth-sandbox.fuse.me/v1/customers/businesses/{customer_id}/shareholders`
- Auth: none required
- TypeScript: <https://skmtc.dev/lorum/apis/auth-api/docs/v1/customers/businesses/:customer_id/shareholders/post.ts> (a function with typed inputs; its response is checked against the schema)

> **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.dev/lorum/apis/auth-api.md) - [All operations](https://skmtc.dev/lorum/apis/auth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lorum/apis/auth-api/revisions/f9b8935027e3?raw)