---
title: "Changes to Retrieve a return"
method: GET
path: "/returns/{returnId}"
---

# Changes to Retrieve a return

`GET /returns/{returnId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 11 revisions.

- **2026-07-13** `859097ed3fe6`: 29 breaking, 10 warning, 27 info

## Changes

- **2026-07-13** `859097ed3fe6`: 29 breaking, 10 warning, 27 info
  - the response property `data/attributes/approved_at` became nullable for the status `200`
  - the response property `data/attributes/archived_at` became nullable for the status `200`
  - the response property `data/attributes/cancelled_at` became nullable for the status `200`
  - the response property `data/attributes/customer_email` became nullable for the status `200`
  - the response property `data/attributes/metadata` became nullable for the status `200`
  - the response property `data/attributes/number` became nullable for the status `200`
  - the response property `data/attributes/received_at` 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/attributes/rejected_at` became nullable for the status `200`
  - the response property `data/attributes/shipped_at` became nullable for the status `200`
  - the response property `data/attributes/skus_count` 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/id` from the response with the `200` status
  - removed the required property `data/relationships/customer/type` from the response with the `200` status
  - removed the required property `data/relationships/destination_address/id` from the response with the `200` status
  - removed the required property `data/relationships/destination_address/type` from the response with the `200` status
  - removed the required property `data/relationships/order/id` from the response with the `200` status
  - removed the required property `data/relationships/order/type` from the response with the `200` status
  - removed the required property `data/relationships/origin_address/id` from the response with the `200` status
  - removed the required property `data/relationships/origin_address/type` from the response with the `200` status
  - removed the required property `data/relationships/return_line_items/id` from the response with the `200` status
  - removed the required property `data/relationships/return_line_items/type` from the response with the `200` status
  - removed the required property `data/relationships/stock_location/id` from the response with the `200` status
  - removed the required property `data/relationships/stock_location/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 `approved` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `cancelled` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `draft` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `received` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `refunded` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `rejected` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `requested` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `returns` enum value to the `data/type` response property for the response status `200`
  - added the new `shipped` enum value to the `data/attributes/status` response property for the response status `200`
  - added the optional property `data/attributes/estimated_refund_amount_cents` to the response with the `200` status
  - …26 more

---

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