---
title: "Changes to GET /contracts"
method: GET
path: "/contracts"
---

# Changes to GET /contracts

`GET /contracts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 12 revisions.

- **2025-05-17** `2de715cbd1f3`: 1 breaking, 22 info
- **2023-12-01** `22a697bcb678`: 1 breaking, 21 warning, 1 info
- **2022-12-08** `86adefb0bb29`: 1 breaking, 22 info
- **2022-06-30** `6118e3620603`: 1 breaking, 22 warning, 6 info
- **2021-09-27** `690ac65fe824`: 1 breaking, 2 warning, 4 info

## Changes

- **2025-05-17** `2de715cbd1f3`: 1 breaking, 22 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 optional property `items/activation` to the response with the `200` status
  - added the optional property `items/agreement` to the response with the `200` status
  - added the optional property `items/creator` to the response with the `200` status
  - added the optional property `items/enrolled` 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/expire_at` 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/issuer` to the response with the `200` status
  - added the optional property `items/kind` to the response with the `200` status
  - added the optional property `items/latest` to the response with the `200` status
  - added the optional property `items/name` to the response with the `200` status
  - added the optional property `items/note` to the response with the `200` status
  - added the optional property `items/owner` to the response with the `200` status
  - added the optional property `items/signee` to the response with the `200` status
  - added the optional property `items/status` to the response with the `200` status
  - added the optional property `items/termination_note` to the response with the `200` status
  - added the optional property `items/type` to the response with the `200` status
  - added the optional property `items/version` to the response with the `200` status
  - added the optional property `items/version_created` to the response with the `200` status
  - added the optional write-only property `items/permissions` to the response with the `200` status
- **2023-12-01** `22a697bcb678`: 1 breaking, 21 warning, 1 info
  - the `items/` response's property type changed from `object` to no type for status `200`
  - deleted the `query` request parameter `limit`
  - deleted the `query` request parameter `offset`
  - removed the optional property `items/activation` from the response with the `200` status
  - removed the optional property `items/agreement` from the response with the `200` status
  - removed the optional property `items/creator` from the response with the `200` status
  - removed the optional property `items/enrolled` 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/expire_at` 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/issuer` from the response with the `200` status
  - removed the optional property `items/kind` from the response with the `200` status
  - removed the optional property `items/latest` from the response with the `200` status
  - removed the optional property `items/name` from the response with the `200` status
  - removed the optional property `items/note` from the response with the `200` status
  - removed the optional property `items/owner` from the response with the `200` status
  - removed the optional property `items/signee` from the response with the `200` status
  - removed the optional property `items/status` from the response with the `200` status
  - removed the optional property `items/termination_note` from the response with the `200` status
  - removed the optional property `items/type` from the response with the `200` status
  - removed the optional property `items/version` from the response with the `200` status
  - removed the optional property `items/version_created` from the response with the `200` status
  - removed the optional write-only property `items/permissions` from the response with the `200` status
- **2022-12-08** `86adefb0bb29`: 1 breaking, 22 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 optional property `items/activation` to the response with the `200` status
  - added the optional property `items/agreement` to the response with the `200` status
  - added the optional property `items/creator` to the response with the `200` status
  - added the optional property `items/enrolled` 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/expire_at` 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/issuer` to the response with the `200` status
  - added the optional property `items/kind` to the response with the `200` status
  - added the optional property `items/latest` to the response with the `200` status
  - added the optional property `items/name` to the response with the `200` status
  - added the optional property `items/note` to the response with the `200` status
  - added the optional property `items/owner` to the response with the `200` status
  - added the optional property `items/signee` to the response with the `200` status
  - added the optional property `items/status` to the response with the `200` status
  - added the optional property `items/termination_note` to the response with the `200` status
  - added the optional property `items/type` to the response with the `200` status
  - added the optional property `items/version` to the response with the `200` status
  - added the optional property `items/version_created` to the response with the `200` status
  - added the optional write-only property `items/permissions` to the response with the `200` status
- **2022-06-30** `6118e3620603`: 1 breaking, 22 warning, 6 info
  - the `items/` response's property type changed from `object` to no type for status `200`
  - removed the optional property `items/activation` from the response with the `200` status
  - removed the optional property `items/agreement` from the response with the `200` status
  - removed the optional property `items/creator` from the response with the `200` status
  - removed the optional property `items/enrolled` 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/expire_at` 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/issuer` from the response with the `200` status
  - removed the optional property `items/kind` from the response with the `200` status
  - removed the optional property `items/latest` from the response with the `200` status
  - removed the optional property `items/marketplace` from the response with the `200` status
  - removed the optional property `items/name` from the response with the `200` status
  - removed the optional property `items/note` from the response with the `200` status
  - removed the optional property `items/owner` from the response with the `200` status
  - removed the optional property `items/partner` from the response with the `200` status
  - removed the optional property `items/referral` from the response with the `200` status
  - removed the optional property `items/signee` from the response with the `200` status
  - removed the optional property `items/status` from the response with the `200` status
  - removed the optional property `items/termination_note` from the response with the `200` status
  - removed the optional property `items/type` from the response with the `200` status
  - removed the optional property `items/version` from the response with the `200` status
  - removed the optional property `items/version_created` from the response with the `200` status
  - api operation id `contract_list_listContracts` removed and replaced with `dp_contract_list_listContracts`
  - added the new optional `query` request parameter `agreement.product_groups.id`
  - added the new optional `query` request parameter `agreement.product_groups.products.id`
  - added the new optional `query` request parameter `agreement.sourcing_agreement.id`
  - added the new optional `query` request parameter `agreement.sourcing_agreement.type`
  - removed the optional write-only property `items/permissions` from the response with the `200` status
- **2021-09-27** `690ac65fe824`: 1 breaking, 2 warning, 4 info
  - the `items/signee` response's property type changed from `object` to no type for status `200`
  - removed the optional property `items/signee/id` from the response with the `200` status
  - removed the optional property `items/signee/name` from the response with the `200` status
  - added the optional property `items/creator/icon` to the response with the `200` status
  - added the optional property `items/issuer/icon` to the response with the `200` status
  - added the optional property `items/owner/icon` to the response with the `200` status
  - added the optional property `items/referral/account/icon` to the response with the `200` status

---

[Operation](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api/docs/contracts/get.md) - [API](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api.md) - [Page](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api/changes/contracts/get)