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

# Changes to GET /agreements

`GET /agreements`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 12 revisions.

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

## Changes

- **2026-11-05** `798ba51500b5`: 4 info
  - added the new optional `query` request parameter `action`
  - added the new optional `query` request parameter `agreements.action`
  - added the new optional `query` request parameter `agreements.marketplace.id`
  - added the new optional `query` request parameter `agreements.marketplace.name`
- **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/auto_accept` to the response with the `200` status
  - added the optional property `items/created` to the response with the `200` status
  - added the optional property `items/document_type` 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/forms` 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/owner` to the response with the `200` status
  - added the optional property `items/parent` to the response with the `200` status
  - added the optional property `items/sourcing_agreement` to the response with the `200` status
  - added the optional property `items/stats` to the response with the `200` status
  - added the optional property `items/title` 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/updated` to the response with the `200` status
  - added the optional property `items/version` to the response with the `200` status
  - added the optional write-only property `items/active` to the response with the `200` status
  - added the optional write-only property `items/file` to the response with the `200` status
  - added the optional write-only property `items/link` to the response with the `200` status
  - added the required property `items/description` to the response with the `200` status
  - added the required property `items/marketplace` to the response with the `200` status
  - added the required property `items/name` to the response with the `200` status
- **2023-12-01** `22a697bcb678`: 4 breaking, 16 warning, 3 info
  - the `items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/description` from the response with the `200` status
  - removed the required property `items/marketplace` from the response with the `200` status
  - removed the required property `items/name` from the response with the `200` status
  - deleted the `query` request parameter `limit`
  - deleted the `query` request parameter `offset`
  - removed the optional property `items/auto_accept` from the response with the `200` status
  - removed the optional property `items/created` from the response with the `200` status
  - removed the optional property `items/document_type` 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/forms` 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/owner` from the response with the `200` status
  - removed the optional property `items/parent` from the response with the `200` status
  - removed the optional property `items/sourcing_agreement` from the response with the `200` status
  - removed the optional property `items/stats` from the response with the `200` status
  - removed the optional property `items/title` 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/updated` from the response with the `200` status
  - removed the optional property `items/version` from the response with the `200` status
  - removed the optional write-only property `items/active` from the response with the `200` status
  - removed the optional write-only property `items/file` from the response with the `200` status
  - removed the optional write-only property `items/link` 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/auto_accept` to the response with the `200` status
  - added the optional property `items/created` to the response with the `200` status
  - added the optional property `items/document_type` 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/forms` 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/owner` to the response with the `200` status
  - added the optional property `items/parent` to the response with the `200` status
  - added the optional property `items/sourcing_agreement` to the response with the `200` status
  - added the optional property `items/stats` to the response with the `200` status
  - added the optional property `items/title` 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/updated` to the response with the `200` status
  - added the optional property `items/version` to the response with the `200` status
  - added the optional write-only property `items/active` to the response with the `200` status
  - added the optional write-only property `items/file` to the response with the `200` status
  - added the optional write-only property `items/link` to the response with the `200` status
  - added the required property `items/description` to the response with the `200` status
  - added the required property `items/marketplace` to the response with the `200` status
  - added the required property `items/name` to the response with the `200` status
- **2022-06-30** `6118e3620603`: 4 breaking, 10 warning, 3 info
  - the `items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/description` from the response with the `200` status
  - removed the required property `items/title` from the response with the `200` status
  - removed the required property `items/type` from the response with the `200` status
  - removed the optional property `items/auto_accept` from the response with the `200` status
  - removed the optional property `items/created` from the response with the `200` status
  - removed the optional property `items/forms` 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/marketplace` 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/parent` from the response with the `200` status
  - removed the optional property `items/stats` from the response with the `200` status
  - removed the optional property `items/updated` from the response with the `200` status
  - removed the optional property `items/version` from the response with the `200` status
  - api operation id `agreement_list_listAgreements` removed and replaced with `dp_agreement_list_listAgreements`
  - removed the optional write-only property `items/active` from the response with the `200` status
  - removed the required write-only property `items/link` from the response with the `200` status
- **2021-09-27** `690ac65fe824`: 1 warning, 1 info
  - removed the optional property `items/agreements` from the response with the `200` status
  - added the optional property `items/owner/icon` to the response with the `200` status

---

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