---
title: "Changes to Retrieve a refund"
method: GET
path: "/refunds/{refundId}"
---

# Changes to Retrieve a refund

`GET /refunds/{refundId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 11 revisions.

- **2026-09-30** `e37b77a53fd0`: 1 info
- **2026-07-13** `859097ed3fe6`: 15 breaking, 2 warning, 14 info

## Changes

- **2026-09-30** `e37b77a53fd0`: 1 info
  - added the optional property `data/attributes/additional_data` to the response with the `200` status
- **2026-07-13** `859097ed3fe6`: 15 breaking, 2 warning, 14 info
  - the response property `data/attributes/error_code` became nullable for the status `200`
  - the response property `data/attributes/error_detail` became nullable for the status `200`
  - the response property `data/attributes/gateway_transaction_id` became nullable for the status `200`
  - the response property `data/attributes/message` 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/attributes/token` 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/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/reference_capture/id` from the response with the `200` status
  - removed the required property `data/relationships/reference_capture/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 `refunds` enum value to the `data/type` response property for the response status `200`
  - added the optional property `data/attributes/payment_method_type` to the response with the `200` status
  - added the optional property `data/attributes/type` 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` to the response with the `200` status
  - added the optional property `data/relationships/event_stores` to the response with the `200` status
  - added the optional property `data/relationships/events` to the response with the `200` status
  - added the optional property `data/relationships/order/data` to the response with the `200` status
  - added the optional property `data/relationships/order/links` to the response with the `200` status
  - added the optional property `data/relationships/payment_source` to the response with the `200` status
  - added the optional property `data/relationships/reference_capture/data` to the response with the `200` status
  - added the optional property `data/relationships/reference_capture/links` to the response with the `200` status
  - added the optional property `data/relationships/return` to the response with the `200` status
  - the `type` response's property default value `refunds` was removed for the status `200`

---

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