---
title: "Changes to Update a shareholder for a Merchant Legal Entity"
method: PUT
path: "/api/v1/merchants/{merchantId}/shareholders/{shareholderId}"
---

# Changes to Update a shareholder for a Merchant Legal Entity

`PUT /api/v1/merchants/{merchantId}/shareholders/{shareholderId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 8 revisions.

- **2026-06-17** `b372e7d5563d`: 9 breaking, 1 warning, 10 info
- **2025-11-05** `113baf476384`: 2 breaking, 46 warning, 4 info
- **2025-11-05** `6637b341d86d`: 1 info
- **2025-11-02** `919eb7a392aa`: 1 breaking

## Changes

- **2026-06-17** `b372e7d5563d`: 9 breaking, 1 warning, 10 info
  - removed `subschema #1: Company Legal Entity Update, subschema #2: Individual Legal Entity Update` from the `legal_entity` request property `anyOf` list
  - added the pattern `^[A-Za-z]{2}$` to the request property `ownership_details/id_issue_country`
  - the `legal_entity` request property type changed from no type to `object`
  - the `ownership_details/id_type` request property type changed from `string` to no type
  - the `data/ownership_details/ownership_share` response property's min was decreased from `10.00` to `0.00` for the response status `200`
  - added `subschema #1: Company Legal Entity, subschema #2: Individual Legal Entity` to the `data/legal_entity` response property `oneOf` list for the response status `200`
  - the `data/legal_entity` response's property type changed from no type to `object` for status `200`
  - the `data/ownership_details/id_type` response's property type changed from `string` to no type for status `200`
  - the `error/code` response's property type changed from `string` to no type for status `400`
  - removed the optional property `error/errors` from the response with the `400` status
  - added `subschema #1, subschema #2, subschema #3` to the `ownership_details/id_type` request property `anyOf` list
  - added discriminator to `legal_entity` request property
  - the `ownership_details/ownership_share` request property's min was decreased from `10.00` to `0.00`
  - added `subschema #1: Company Legal Entity Update, subschema #2: Individual Legal Entity Update` to the `legal_entity` request property `oneOf` list
  - added the optional property `error/metadata` to the response with the `400` status
  - added `subschema #1, subschema #2` to the `error/code` response property `allOf` list for the response status `400`
  - added `subschema #1, subschema #2, subschema #3` to the `data/ownership_details/id_type` response property `anyOf` list for the response status `200`
  - removed `subschema #1: Company Legal Entity, subschema #2: Individual Legal Entity` from the `data/legal_entity` response property `anyOf` list for the response status `200`
  - added discriminator to `data/legal_entity` response property for the response status `200`
  - the `data/ownership_details/id_issue_country` response's property pattern `^[A-Za-z]{2}$` was added for the status `200`
- **2025-11-05** `113baf476384`: 2 breaking, 46 warning, 4 info
  - the `legal_entity` request property type changed from `object` to no type
  - the `data/legal_entity` response's property type changed from `object` to no type for status `200`
  - removed the request property `legal_entity/annual_revenue_amount`
  - removed the request property `legal_entity/annual_revenue_currency`
  - removed the request property `legal_entity/citizenship`
  - removed the request property `legal_entity/company_name`
  - removed the request property `legal_entity/company_number`
  - removed the request property `legal_entity/company_operating_address`
  - removed the request property `legal_entity/company_structure`
  - removed the request property `legal_entity/contact_email`
  - removed the request property `legal_entity/contact_name`
  - removed the request property `legal_entity/contact_phone_number`
  - removed the request property `legal_entity/country_of_incorporation`
  - removed the request property `legal_entity/dob`
  - removed the request property `legal_entity/email`
  - removed the request property `legal_entity/employees_number`
  - removed the request property `legal_entity/first_name`
  - removed the request property `legal_entity/incorporation_date`
  - removed the request property `legal_entity/last_name`
  - removed the request property `legal_entity/phone_number`
  - removed the request property `legal_entity/registered_office_address`
  - removed the request property `legal_entity/residency_address`
  - removed the request property `legal_entity/tax_id`
  - removed the request property `legal_entity/type`
  - removed the request property `legal_entity/vat_number`
  - removed the optional property `data/legal_entity/annual_revenue_amount` from the response with the `200` status
  - removed the optional property `data/legal_entity/annual_revenue_currency` from the response with the `200` status
  - removed the optional property `data/legal_entity/citizenship` from the response with the `200` status
  - removed the optional property `data/legal_entity/company_name` from the response with the `200` status
  - removed the optional property `data/legal_entity/company_number` from the response with the `200` status
  - removed the optional property `data/legal_entity/company_operating_address` from the response with the `200` status
  - removed the optional property `data/legal_entity/company_structure` from the response with the `200` status
  - removed the optional property `data/legal_entity/contact_email` from the response with the `200` status
  - removed the optional property `data/legal_entity/contact_name` from the response with the `200` status
  - removed the optional property `data/legal_entity/contact_phone_number` from the response with the `200` status
  - removed the optional property `data/legal_entity/country_of_incorporation` from the response with the `200` status
  - removed the optional property `data/legal_entity/dob` from the response with the `200` status
  - removed the optional property `data/legal_entity/email` from the response with the `200` status
  - removed the optional property `data/legal_entity/employees_number` from the response with the `200` status
  - removed the optional property `data/legal_entity/first_name` from the response with the `200` status
  - …12 more
- **2025-11-05** `6637b341d86d`: 1 info
  - endpoint added
- **2025-11-02** `919eb7a392aa`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/banqzinc/apis/quidkey-api/docs/api/v1/merchants/:merchantId/shareholders/:shareholderId/put.md) - [API](https://skmtc.dev/banqzinc/apis/quidkey-api.md) - [Page](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/merchants/:merchantId/shareholders/:shareholderId/put)
