---
title: "Changes to Retrieve a free shipping promotion"
method: GET
path: "/free_shipping_promotions/{freeShippingPromotionId}"
---

# Changes to Retrieve a free shipping promotion

`GET /free_shipping_promotions/{freeShippingPromotionId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 11 revisions.

- **2026-07-13** `859097ed3fe6`: 22 breaking, 2 warning, 29 info

## Changes

- **2026-07-13** `859097ed3fe6`: 22 breaking, 2 warning, 29 info
  - the response property `data/attributes/active` became nullable for the status `200`
  - the response property `data/attributes/currency_code` 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/total_usage_count` became nullable for the status `200`
  - the response property `data/attributes/total_usage_limit` 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/coupon_codes_promotion_rule/id` from the response with the `200` status
  - removed the required property `data/relationships/coupon_codes_promotion_rule/type` from the response with the `200` status
  - removed the required property `data/relationships/market/id` from the response with the `200` status
  - removed the required property `data/relationships/market/type` from the response with the `200` status
  - removed the required property `data/relationships/order_amount_promotion_rule/id` from the response with the `200` status
  - removed the required property `data/relationships/order_amount_promotion_rule/type` from the response with the `200` status
  - removed the required property `data/relationships/promotion_rules/id` from the response with the `200` status
  - removed the required property `data/relationships/promotion_rules/type` from the response with the `200` status
  - removed the required property `data/relationships/sku_list_promotion_rule/id` from the response with the `200` status
  - removed the required property `data/relationships/sku_list_promotion_rule/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 `free_shipping_promotions` enum value to the `data/type` response property for the response status `200`
  - added the optional property `data/attributes/coupons_count` to the response with the `200` status
  - added the optional property `data/attributes/disabled_at` to the response with the `200` status
  - added the optional property `data/attributes/exclusive` to the response with the `200` status
  - added the optional property `data/attributes/priority` to the response with the `200` status
  - added the optional property `data/attributes/status` to the response with the `200` status
  - added the optional property `data/attributes/total_usage_reached` 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/attributes/weight` 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/coupon_codes_promotion_rule/data` to the response with the `200` status
  - added the optional property `data/relationships/coupon_codes_promotion_rule/links` to the response with the `200` status
  - added the optional property `data/relationships/coupons` to the response with the `200` status
  - added the optional property `data/relationships/custom_promotion_rule` to the response with the `200` status
  - …13 more

---

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