---
title: "Changes to Retrieve a customer"
method: GET
path: "/customers/{customerId}"
---

# Changes to Retrieve a customer

`GET /customers/{customerId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 11 revisions.

- **2026-07-13** `859097ed3fe6`: 23 breaking, 5 warning, 33 info

## Changes

- **2026-07-13** `859097ed3fe6`: 23 breaking, 5 warning, 33 info
  - the response property `data/attributes/has_password` became nullable for the status `200`
  - the response property `data/attributes/metadata` became nullable for the status `200`
  - the response property `data/attributes/reference` became nullable for the status `200`
  - the response property `data/attributes/reference_origin` became nullable for the status `200`
  - the response property `data` became optional for the status `200`
  - the response property `data/attributes` became optional for the status `200`
  - the response property `data/type` became optional for the status `200`
  - removed the required property `data/relationships/attachments/id` from the response with the `200` status
  - removed the required property `data/relationships/attachments/type` from the response with the `200` status
  - removed the required property `data/relationships/customer_addresses/id` from the response with the `200` status
  - removed the required property `data/relationships/customer_addresses/type` from the response with the `200` status
  - removed the required property `data/relationships/customer_group/id` from the response with the `200` status
  - removed the required property `data/relationships/customer_group/type` from the response with the `200` status
  - removed the required property `data/relationships/customer_payment_sources/id` from the response with the `200` status
  - removed the required property `data/relationships/customer_payment_sources/type` from the response with the `200` status
  - removed the required property `data/relationships/customer_subscriptions/id` from the response with the `200` status
  - removed the required property `data/relationships/customer_subscriptions/type` from the response with the `200` status
  - removed the required property `data/relationships/order_subscriptions/id` from the response with the `200` status
  - removed the required property `data/relationships/order_subscriptions/type` from the response with the `200` status
  - removed the required property `data/relationships/orders/id` from the response with the `200` status
  - removed the required property `data/relationships/orders/type` from the response with the `200` status
  - removed the required property `data/relationships/returns/id` from the response with the `200` status
  - removed the required property `data/relationships/returns/type` from the response with the `200` status
  - removed the optional property `data/attributes/id` from the response with the `200` status
  - added the new `acquired` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `customers` enum value to the `data/type` response property for the response status `200`
  - added the new `prospect` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `repeat` enum value to the `data/attributes/status` response property for the response status `200`
  - added the optional property `data/attributes/anonymization_info` to the response with the `200` status
  - added the optional property `data/attributes/anonymization_status` to the response with the `200` status
  - added the optional property `data/attributes/jwt_custom_claim` to the response with the `200` status
  - added the optional property `data/attributes/profile_id` to the response with the `200` status
  - added the optional property `data/attributes/shopper_reference` to the response with the `200` status
  - added the optional property `data/attributes/tax_exemption_code` to the response with the `200` status
  - added the optional property `data/attributes/total_orders_count` to the response with the `200` status
  - added the optional property `data/id` to the response with the `200` status
  - added the optional property `data/links` to the response with the `200` status
  - added the optional property `data/relationships/attachments/data` to the response with the `200` status
  - added the optional property `data/relationships/attachments/links` to the response with the `200` status
  - added the optional property `data/relationships/customer_addresses/data` to the response with the `200` status
  - …21 more

---

[Operation](https://skmtc.dev/commercelayer/apis/commerce-layer-api/docs/customers/:customerId/get.md) - [API](https://skmtc.dev/commercelayer/apis/commerce-layer-api.md) - [Page](https://skmtc.dev/commercelayer/apis/commerce-layer-api/changes/customers/:customerId/get)