---
title: "Changes to Retrieve a shipment"
method: GET
path: "/shipments/{shipmentId}"
---

# Changes to Retrieve a shipment

`GET /shipments/{shipmentId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 11 revisions.

- **2026-10-13** `7626ac743941`: 1 info
- **2026-07-13** `859097ed3fe6`: 48 breaking, 11 warning, 45 info

## Changes

- **2026-10-13** `7626ac743941`: 1 info
  - added the optional property `data/attributes/store_shipment_policy` to the response with the `200` status
- **2026-07-13** `859097ed3fe6`: 48 breaking, 11 warning, 45 info
  - the response property `data/attributes/cost_amount_cents` became nullable for the status `200`
  - the response property `data/attributes/cost_amount_float` became nullable for the status `200`
  - the response property `data/attributes/currency_code` became nullable for the status `200`
  - the response property `data/attributes/formatted_cost_amount` became nullable for the status `200`
  - the response property `data/attributes/get_rates_completed_at` became nullable for the status `200`
  - the response property `data/attributes/get_rates_started_at` became nullable for the status `200`
  - the response property `data/attributes/metadata` became nullable for the status `200`
  - the response property `data/attributes/purchase_completed_at` became nullable for the status `200`
  - the response property `data/attributes/purchase_error_code` became nullable for the status `200`
  - the response property `data/attributes/purchase_error_message` became nullable for the status `200`
  - the response property `data/attributes/purchase_failed_at` became nullable for the status `200`
  - the response property `data/attributes/purchase_started_at` became nullable for the status `200`
  - the response property `data/attributes/rates` 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/selected_rate_id` 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/available_shipping_methods/id` from the response with the `200` status
  - removed the required property `data/relationships/available_shipping_methods/type` from the response with the `200` status
  - removed the required property `data/relationships/carrier_accounts/id` from the response with the `200` status
  - removed the required property `data/relationships/carrier_accounts/type` from the response with the `200` status
  - removed the required property `data/relationships/delivery_lead_time/id` from the response with the `200` status
  - removed the required property `data/relationships/delivery_lead_time/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/parcels/id` from the response with the `200` status
  - removed the required property `data/relationships/parcels/type` from the response with the `200` status
  - removed the required property `data/relationships/shipment_line_items/id` from the response with the `200` status
  - removed the required property `data/relationships/shipment_line_items/type` from the response with the `200` status
  - removed the required property `data/relationships/shipping_address/id` from the response with the `200` status
  - removed the required property `data/relationships/shipping_address/type` from the response with the `200` status
  - removed the required property `data/relationships/shipping_category/id` from the response with the `200` status
  - removed the required property `data/relationships/shipping_category/type` from the response with the `200` status
  - …64 more

---

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