---
title: "Changes to Update a legal entity for a merchant"
method: PUT
path: "/api/v1/merchants/{id}/legal-entities"
---

# Changes to Update a legal entity for a merchant

`PUT /api/v1/merchants/{id}/legal-entities`

> 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`: 5 breaking, 47 warning, 2 info
- **2025-11-05** `6637b341d86d`: 1 info
- **2025-11-02** `919eb7a392aa`: 1 breaking

## Changes

- **2026-06-17** `b372e7d5563d`: 5 breaking, 1 warning, 6 info
  - removed `subschema #1: Company Legal Entity Update, subschema #2: Individual Legal Entity Update` from the request body `anyOf` list
  - the request's body type changed from no type to `object`
  - added `subschema #1: Company Legal Entity, subschema #2: Individual Legal Entity` to the `data` response property `oneOf` list for the response status `200`
  - the `data` response's property type changed from no type to `object` 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 request discriminator
  - added `subschema #1: Company Legal Entity Update, subschema #2: Individual Legal Entity Update` to the request body `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`
  - removed `subschema #1: Company Legal Entity, subschema #2: Individual Legal Entity` from the `data` response property `anyOf` list for the response status `200`
  - added discriminator to `data` response property for the response status `200`
- **2025-11-05** `113baf476384`: 5 breaking, 47 warning, 2 info
  - the request's body type changed from `object` to no type
  - the `data` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/id` from the response with the `200` status
  - removed the required property `data/verification_required` from the response with the `200` status
  - removed the required property `data/verification_status` from the response with the `200` status
  - removed the request property `annual_revenue_amount`
  - removed the request property `annual_revenue_currency`
  - removed the request property `citizenship`
  - removed the request property `company_name`
  - removed the request property `company_number`
  - removed the request property `company_operating_address`
  - removed the request property `company_structure`
  - removed the request property `contact_email`
  - removed the request property `contact_name`
  - removed the request property `contact_phone_number`
  - removed the request property `country_of_incorporation`
  - removed the request property `dob`
  - removed the request property `email`
  - removed the request property `employees_number`
  - removed the request property `first_name`
  - removed the request property `incorporation_date`
  - removed the request property `last_name`
  - removed the request property `phone_number`
  - removed the request property `registered_office_address`
  - removed the request property `residency_address`
  - removed the request property `tax_id`
  - removed the request property `type`
  - removed the request property `vat_number`
  - removed the optional property `data/annual_revenue_amount` from the response with the `200` status
  - removed the optional property `data/annual_revenue_currency` from the response with the `200` status
  - removed the optional property `data/citizenship` from the response with the `200` status
  - removed the optional property `data/company_name` from the response with the `200` status
  - removed the optional property `data/company_number` from the response with the `200` status
  - removed the optional property `data/company_operating_address` from the response with the `200` status
  - removed the optional property `data/company_structure` from the response with the `200` status
  - removed the optional property `data/contact_email` from the response with the `200` status
  - removed the optional property `data/contact_name` from the response with the `200` status
  - removed the optional property `data/contact_phone_number` from the response with the `200` status
  - removed the optional property `data/country_of_incorporation` from the response with the `200` status
  - removed the optional property `data/dob` from the response with the `200` status
  - …14 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/:id/legal-entities/put.md) - [API](https://skmtc.dev/banqzinc/apis/quidkey-api.md) - [Page](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/merchants/:id/legal-entities/put)