---
title: "Changes to Delete customer by ID"
method: DELETE
path: "/customers/{customerId}"
---

# Changes to Delete customer by ID

`DELETE /customers/{customerId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 24 revisions.

- **2026-08-15** `27ff0fdca01c` — 3 warning, 3 info
- **2026-08-06** `526036c12609` — 6 info
- **2026-07-31** `b21ed434ee6e` — 2 breaking, 13 warning, 1 info

## Changes

- **2026-08-15** `27ff0fdca01c` — 3 warning, 3 info
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/taxIdCountryOfIssuance` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/taxIdType` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/taxIdentifier` from the response with the `200` status
  - added the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/countryOfIssuance` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/idType` to the response with the `200` status
  - added the optional write-only property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/identifier` to the response with the `200` status
- **2026-08-06** `526036c12609` — 6 info
  - added the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/Customer]/endUserTermsConsent` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/primaryContactFirstName` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/primaryContactLastName` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/Customer]/endUserTermsConsent` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/primaryContactFirstName` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/primaryContactLastName` to the response with the `200` status
- **2026-07-31** `b21ed434ee6e` — 2 breaking, 13 warning, 1 info
  - the `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/customerType` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/address` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/birthDate` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/fullName` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/kycStatus` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/nationality` from the response with the `200` status
  - added the new `CHARITY` enum value to the `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/entityType` response property for the response status `200`
  - added the new `CHARITY` enum value to the `oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/entityType` response property for the response status `200`
  - added the new `PRIVATE_FOUNDATION` enum value to the `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/entityType` response property for the response status `200`
  - added the new `PRIVATE_FOUNDATION` enum value to the `oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/entityType` response property for the response status `200`
  - added the new `PUBLICLY_LISTED_COMPANY` enum value to the `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/entityType` response property for the response status `200`
  - added the new `PUBLICLY_LISTED_COMPANY` enum value to the `oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/entityType` response property for the response status `200`
  - added the new `TRUST` enum value to the `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/entityType` response property for the response status `200`
  - added the new `TRUST` enum value to the `oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/entityType` response property for the response status `200`
  - added `#/components/schemas/CustomerEdd, subschema #1` to the `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/` response property `allOf` list for the response status `200`

---

[Operation](https://skmtc.dev/stainless-api/apis/grid-api/docs/customers/:customerId/delete.md) · [API](https://skmtc.dev/stainless-api/apis/grid-api.md) · [Page](https://skmtc.dev/stainless-api/apis/grid-api/changes/customers/:customerId/delete)