---
title: "Changes to GET /offers/{offer_id}/versions/{offerversion_id}/plans"
method: GET
path: "/offers/{offer_id}/versions/{offerversion_id}/plans"
---

# Changes to GET /offers/{offer_id}/versions/{offerversion_id}/plans

`GET /offers/{offer_id}/versions/{offerversion_id}/plans`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 12 revisions.

- **2026-11-05** `798ba51500b5`: 2 info
- **2026-03-10** `ed203419a9a7`: 4 warning, 10 info
- **2025-05-17** `2de715cbd1f3`: 1 info
- **2025-02-06** `02f3fa5caab8`: 1 breaking
- **2023-12-01** `22a697bcb678`: 5 breaking, 6 warning, 1 info
- **2022-12-08** `86adefb0bb29`: 1 breaking, 11 info
- **2022-06-30** `6118e3620603`: 1 info
- **2021-09-27** `690ac65fe824`: 4 breaking, 4 warning, 1 info

## Changes

- **2026-11-05** `798ba51500b5`: 2 info
  - added the new optional `query` request parameter `blueprint.status`
  - added the new optional `query` request parameter `external_id`
- **2026-03-10** `ed203419a9a7`: 4 warning, 10 info
  - removed the optional property `items/countries` from the response with the `200` status
  - removed the optional property `items/form` from the response with the `200` status
  - removed the optional property `items/preset` from the response with the `200` status
  - removed the optional property `items/status` from the response with the `200` status
  - added the new optional `query` request parameter `commitments`
  - added the optional property `items/commitments` to the response with the `200` status
  - added the optional property `items/description` to the response with the `200` status
  - added the optional property `items/events` to the response with the `200` status
  - added the optional property `items/external_id` to the response with the `200` status
  - added the optional property `items/position` to the response with the `200` status
  - added the optional write-only property `items/gravity` to the response with the `200` status
  - added the required property `items/color` to the response with the `200` status
  - added the required property `items/name` to the response with the `200` status
  - added the required property `items/periods` to the response with the `200` status
- **2025-05-17** `2de715cbd1f3`: 1 info
  - endpoint added
- **2025-02-06** `02f3fa5caab8`: 1 breaking
  - api path removed without deprecation
- **2023-12-01** `22a697bcb678`: 5 breaking, 6 warning, 1 info
  - removed the media type `application/json` for the response with the status `400`
  - the `items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/color` from the response with the `200` status
  - removed the required property `items/name` from the response with the `200` status
  - removed the required property `items/periods` from the response with the `200` status
  - deleted the `query` request parameter `limit`
  - deleted the `query` request parameter `offset`
  - removed the optional property `items/description` from the response with the `200` status
  - removed the optional property `items/events` from the response with the `200` status
  - removed the optional property `items/id` from the response with the `200` status
  - removed the optional property `items/position` from the response with the `200` status
  - removed the optional write-only property `items/gravity` from the response with the `200` status
- **2022-12-08** `86adefb0bb29`: 1 breaking, 11 info
  - the `items/` response's property type changed from no type to `object` for status `200`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `offset`
  - added the media type `application/json` for the response with the status `400`
  - added the optional property `items/description` to the response with the `200` status
  - added the optional property `items/events` to the response with the `200` status
  - added the optional property `items/id` to the response with the `200` status
  - added the optional property `items/position` to the response with the `200` status
  - added the optional write-only property `items/gravity` to the response with the `200` status
  - added the required property `items/color` to the response with the `200` status
  - added the required property `items/name` to the response with the `200` status
  - added the required property `items/periods` to the response with the `200` status
- **2022-06-30** `6118e3620603`: 1 info
  - api operation id `offerversion_plans_list_listPlanVersions` removed and replaced with `offers_offerversion_plans_list_listPlanVersions`
- **2021-09-27** `690ac65fe824`: 4 breaking, 4 warning, 1 info
  - the `items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/color` from the response with the `200` status
  - removed the required property `items/name` from the response with the `200` status
  - removed the required property `items/periods` from the response with the `200` status
  - removed the optional property `items/description` from the response with the `200` status
  - removed the optional property `items/events` from the response with the `200` status
  - removed the optional property `items/id` from the response with the `200` status
  - removed the optional property `items/position` from the response with the `200` status
  - removed the optional write-only property `items/gravity` from the response with the `200` status

---

[Operation](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api/docs/offers/:offer_id/versions/:offerversion_id/plans/get.md) - [API](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api.md) - [Page](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api/changes/offers/:offer_id/versions/:offerversion_id/plans/get)