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

# Changes to GET /listings

`GET /listings`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 12 revisions.

- **2026-03-10** `ed203419a9a7`: 6 info
- **2025-05-17** `2de715cbd1f3`: 1 breaking, 13 info
- **2023-12-01** `22a697bcb678`: 5 breaking, 9 warning
- **2022-12-08** `86adefb0bb29`: 1 breaking, 13 info
- **2022-06-30** `6118e3620603`: 6 breaking, 14 warning, 1 info
- **2021-09-27** `690ac65fe824`: 7 info

## Changes

- **2026-03-10** `ed203419a9a7`: 6 info
  - added the new optional `query` request parameter `alt_pricelist_1.id`
  - added the new optional `query` request parameter `alt_pricelist_1.name`
  - added the new optional `query` request parameter `alt_pricelist_2.id`
  - added the new optional `query` request parameter `alt_pricelist_2.name`
  - added the required property `items/alt_pricelist_1` to the response with the `200` status
  - added the required property `items/alt_pricelist_2` to the response with the `200` status
- **2025-05-17** `2de715cbd1f3`: 1 breaking, 13 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/contract` 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/id` to the response with the `200` status
  - added the optional property `items/pending_request` to the response with the `200` status
  - added the optional property `items/product` to the response with the `200` status
  - added the optional property `items/provider` 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/updated` to the response with the `200` status
  - added the optional property `items/vendor` to the response with the `200` status
  - added the required property `items/offer` to the response with the `200` status
  - added the required property `items/pricelist` to the response with the `200` status
- **2023-12-01** `22a697bcb678`: 5 breaking, 9 warning
  - the `items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/offer` from the response with the `200` status
  - removed the required property `items/pricelist` from the response with the `200` status
  - removed the required property `items/provider` from the response with the `200` status
  - removed the required property `items/vendor` from the response with the `200` status
  - deleted the `query` request parameter `limit`
  - deleted the `query` request parameter `offset`
  - removed the optional property `items/contract` 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/id` from the response with the `200` status
  - removed the optional property `items/pending_request` from the response with the `200` status
  - removed the optional property `items/product` 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/updated` from the response with the `200` status
- **2022-12-08** `86adefb0bb29`: 1 breaking, 13 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/contract` 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/id` to the response with the `200` status
  - added the optional property `items/pending_request` to the response with the `200` status
  - added the optional property `items/product` 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/updated` to the response with the `200` status
  - added the required property `items/offer` to the response with the `200` status
  - added the required property `items/pricelist` to the response with the `200` status
  - added the required property `items/provider` to the response with the `200` status
  - added the required property `items/vendor` to the response with the `200` status
- **2022-06-30** `6118e3620603`: 6 breaking, 14 warning, 1 info
  - the `items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/offer` from the response with the `200` status
  - removed the required property `items/pricelist` from the response with the `200` status
  - removed the required property `items/provider` from the response with the `200` status
  - removed the required property `items/sourcing` from the response with the `200` status
  - removed the required property `items/vendor` from the response with the `200` status
  - deleted the `query` request parameter `sourcing.id`
  - deleted the `query` request parameter `sourcing.name`
  - deleted the `query` request parameter `sourcing.published`
  - deleted the `query` request parameter `sourcing__agreement__id`
  - deleted the `query` request parameter `sourcing__agreement__name`
  - deleted the `query` request parameter `sourcing__agreement__name__icontains`
  - deleted the `query` request parameter `sourcing__published`
  - removed the optional property `items/contract` 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/id` from the response with the `200` status
  - removed the optional property `items/pending_request` from the response with the `200` status
  - removed the optional property `items/product` 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/updated` from the response with the `200` status
  - api operation id `listing_list_listListings` removed and replaced with `dp_listing_list_listListings`
- **2021-09-27** `690ac65fe824`: 7 info
  - added the optional property `items/provider/icon` to the response with the `200` status
  - added the optional property `items/vendor/icon` to the response with the `200` status
  - the response optional property `items/provider` became not read-only for the status `200`
  - the response optional property `items/vendor` became not read-only for the status `200`
  - the response property `items/provider` became required for the status `200`
  - the response property `items/vendor` became required for the status `200`
  - added the required property `items/sourcing` to the response with the `200` status

---

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