---
title: "Changes to Get shareholders for a Merchant Legal Entity"
method: GET
path: "/api/v1/merchants/{merchantId}/shareholders"
---

# Changes to Get shareholders for a Merchant Legal Entity

`GET /api/v1/merchants/{merchantId}/shareholders`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 8 revisions.

- **2026-06-17** `b372e7d5563d`: 5 breaking, 1 warning, 6 info
- **2025-11-05** `113baf476384`: 1 breaking, 23 warning, 1 info
- **2025-11-05** `6637b341d86d`: 1 info
- **2025-11-02** `919eb7a392aa`: 1 breaking

## Changes

- **2026-06-17** `b372e7d5563d`: 5 breaking, 1 warning, 6 info
  - the `data/items/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/items/legal_entity` response property `oneOf` list for the response status `200`
  - the `data/items/legal_entity` response's property type changed from no type to `object` for status `200`
  - the `data/items/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 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/items/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/items/legal_entity` response property `anyOf` list for the response status `200`
  - added discriminator to `data/items/legal_entity` response property for the response status `200`
  - the `data/items/ownership_details/id_issue_country` response's property pattern `^[A-Za-z]{2}$` was added for the status `200`
- **2025-11-05** `113baf476384`: 1 breaking, 23 warning, 1 info
  - the `data/items/legal_entity` response's property type changed from `object` to no type for status `200`
  - removed the optional property `data/items/legal_entity/annual_revenue_amount` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/annual_revenue_currency` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/citizenship` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/company_name` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/company_number` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/company_operating_address` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/company_structure` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/contact_email` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/contact_name` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/contact_phone_number` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/country_of_incorporation` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/dob` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/email` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/employees_number` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/first_name` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/incorporation_date` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/last_name` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/phone_number` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/registered_office_address` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/residency_address` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/tax_id` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/type` from the response with the `200` status
  - removed the optional property `data/items/legal_entity/vat_number` from the response with the `200` status
  - added `subschema #1: Company Legal Entity, subschema #2: Individual Legal Entity` to the `data/items/legal_entity` response property `anyOf` list for the response status `200`
- **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/get.md) - [API](https://skmtc.dev/banqzinc/apis/quidkey-api.md) - [Page](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/merchants/:merchantId/shareholders/get)