---
title: "Changes to Retrieve an order subscription"
method: GET
path: "/order_subscriptions/{orderSubscriptionId}"
---

# Changes to Retrieve an order subscription

`GET /order_subscriptions/{orderSubscriptionId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 11 revisions.

- **2026-10-08** `71dbd5f83326`: 1 info
- **2026-08-25** `8c992528cc87`: 1 warning
- **2026-07-13** `859097ed3fe6`: 26 breaking, 7 warning, 24 info

## Changes

- **2026-10-08** `71dbd5f83326`: 1 info
  - added the optional property `data/relationships/resource_errors` to the response with the `200` status
- **2026-08-25** `8c992528cc87`: 1 warning
  - added the new `pending` enum value to the `data/attributes/status` response property for the response status `200`
- **2026-07-13** `859097ed3fe6`: 26 breaking, 7 warning, 24 info
  - the response property `data/attributes/activate_by_source_order` became nullable for the status `200`
  - the response property `data/attributes/customer_email` became nullable for the status `200`
  - the response property `data/attributes/errors_count` became nullable for the status `200`
  - the response property `data/attributes/expires_at` became nullable for the status `200`
  - the response property `data/attributes/metadata` became nullable for the status `200`
  - the response property `data/attributes/next_run_at` became nullable for the status `200`
  - the response property `data/attributes/number` became nullable for the status `200`
  - the response property `data/attributes/occurrencies` became nullable for the status `200`
  - the response property `data/attributes/options` 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/starts_at` became nullable for the status `200`
  - the response property `data/attributes/succeeded_on_last_run` 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/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/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_copies/id` from the response with the `200` status
  - removed the required property `data/relationships/order_copies/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/source_order/id` from the response with the `200` status
  - removed the required property `data/relationships/source_order/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 `active` 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 `inactive` enum value to the `data/attributes/status` response property for the response status `200`
  - added the new `order_subscriptions` enum value to the `data/type` response property for the response status `200`
  - added the new `running` enum value to the `data/attributes/status` response property for the response status `200`
  - added the optional property `data/attributes/last_run_at` to the response with the `200` status
  - added the optional property `data/attributes/place_target_order` to the response with the `200` status
  - added the optional property `data/attributes/renewal_alert_period` 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/customer/data` to the response with the `200` status
  - added the optional property `data/relationships/customer/links` to the response with the `200` status
  - …17 more

---

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