---
title: "Changes to List customers"
method: GET
path: "/customers"
---

# Changes to List customers

`GET /customers`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 24 revisions.

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

## Changes

- **2026-08-15** `27ff0fdca01c` — 3 warning, 3 info
  - removed the optional property `data/items/oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/taxIdCountryOfIssuance` from the response with the `200` status
  - removed the optional property `data/items/oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/taxIdType` from the response with the `200` status
  - removed the optional property `data/items/oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/taxIdentifier` from the response with the `200` status
  - added the optional property `data/items/oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/countryOfIssuance` to the response with the `200` status
  - added the optional property `data/items/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 `data/items/oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/identifier` to the response with the `200` status
- **2026-08-14** `aaa1fb8782c8` — 1 warning
  - added the new `EXTERNAL_ACCOUNT_VERIFICATION_REQUIRED` enum value to the `code` response property for the response status `400`
- **2026-08-13** `df12ec487f0e` — 1 warning
  - added the new `TRANSACTION_SIZE_LIMIT_EXCEEDED` enum value to the `code` response property for the response status `400`
- **2026-08-11** `b06902b6595a` — 1 warning
  - added the new `CARDHOLDER_KYC_NOT_APPROVED` enum value to the `code` response property for the response status `400`
- **2026-08-06** `526036c12609` — 1 warning, 6 info
  - added the new `END_USER_TERMS_VERSION_NOT_FOUND` enum value to the `code` response property for the response status `400`
  - added the optional property `data/items/oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/Customer]/endUserTermsConsent` to the response with the `200` status
  - added the optional property `data/items/oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/primaryContactFirstName` to the response with the `200` status
  - added the optional property `data/items/oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/primaryContactLastName` to the response with the `200` status
  - added the optional property `data/items/oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/Customer]/endUserTermsConsent` to the response with the `200` status
  - added the optional property `data/items/oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/primaryContactFirstName` to the response with the `200` status
  - added the optional property `data/items/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, 2 info
  - the `data/items/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 `data/items/oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/customerType` from the response with the `200` status
  - removed the optional property `data/items/oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/address` from the response with the `200` status
  - removed the optional property `data/items/oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/birthDate` from the response with the `200` status
  - removed the optional property `data/items/oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/fullName` from the response with the `200` status
  - removed the optional property `data/items/oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/kycStatus` from the response with the `200` status
  - removed the optional property `data/items/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 `data/items/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 `data/items/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 `data/items/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 `data/items/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 `data/items/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 `data/items/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 `data/items/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 `data/items/oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/entityType` response property for the response status `200`
  - added the optional property `details/errors` to the response with the `400` status
  - added `#/components/schemas/CustomerEdd, subschema #1` to the `data/items/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/get.md) · [API](https://skmtc.dev/stainless-api/apis/grid-api.md) · [Page](https://skmtc.dev/stainless-api/apis/grid-api/changes/customers/get)