--- title: "Changes to List purchases for provider" method: GET path: "/v1/sdk/purchases" --- # Changes to List purchases for provider `GET /v1/sdk/purchases` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 14 of 27 revisions. - **2026-08-13** `e356f6586bf2` — 4 warning - **2026-08-05** `032545ac8d13` — 1 breaking, 4 warning, 3 info - **2026-07-30** `8578b7536a9f` — 2 breaking, 2 info - **2026-07-17** `bbc2ff2bc849` — 2 warning - **2026-07-04** `18486adb15ea` — 1 breaking - **2026-07-04** `a30b6aef464d` — 3 info - **2026-04-26** `60c2cd1caf83` — 1 info - **2026-04-09** `7b327a22e3cb` — 1 warning, 1 info - **2026-04-08** `052cc028fdfa` — 1 breaking, 3 warning, 4 info - **2026-04-04** `88abf6f50f11` — 1 breaking, 1 warning, 3 info - **2026-03-25** `e0583a41987c` — 1 breaking, 23 info - **2026-03-16** `9fd92a720973` — 13 breaking, 11 warning - **2026-03-14** `0e1cded2ee5d` — 1 info - **2026-02-27** `9079f361f51c` — 1 info ## Changes - **2026-08-13** `e356f6586bf2` — 4 warning - removed the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/billingCycle` from the response with the `200` status - removed the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/includedUnits` from the response with the `200` status - removed the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/meterRef` from the response with the `200` status - removed the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/type` from the response with the `200` status - **2026-08-05** `032545ac8d13` — 1 breaking, 4 warning, 3 info - removed the required property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/planType` from the response with the `200` status - removed the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/creditsPerUnit` from the response with the `200` status - removed the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/freeUnits` from the response with the `200` status - removed the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/limit` from the response with the `200` status - removed the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/limits` from the response with the `200` status - added the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/includedUnits` to the response with the `200` status - added the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/options` to the response with the `200` status - added the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/type` to the response with the `200` status - **2026-07-30** `8578b7536a9f` — 2 breaking, 2 info - the response property `purchases/items/customerEmail` became optional for the status `200` - the response property `purchases/items/productRef` became optional for the status `200` - added the optional property `purchases/items/origin` to the response with the `200` status - added the optional property `purchases/items/requiresPayment` to the response with the `200` status - **2026-07-17** `bbc2ff2bc849` — 2 warning - for the `query` request parameter `customerRef`, the maxLength was set to `20` - for the `query` request parameter `productRef`, the maxLength was set to `20` - **2026-07-04** `18486adb15ea` — 1 breaking - for the `query` request parameter `includeFree`, the type changed from no type to `boolean` - **2026-07-04** `a30b6aef464d` — 3 info - the endpoint scheme security `SecretKey` was added to the API - the endpoint scheme security `bearer` was removed from the API - added the new optional `query` request parameter `includeFree` - **2026-04-26** `60c2cd1caf83` — 1 info - added the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/name` to the response with the `200` status - **2026-04-09** `7b327a22e3cb` — 1 warning, 1 info - removed the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/pricePerUnit` from the response with the `200` status - added the optional property `purchases/items/planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/creditsPerUnit` to the response with the `200` status - **2026-04-08** `052cc028fdfa` — 1 breaking, 3 warning, 4 info - removed the required property `purchases/items/id` from the response with the `200` status - deleted the `query` request parameter `customerId` - deleted the `query` request parameter `productId` - removed the optional property `purchases/items/productId` from the response with the `200` status - added the new optional `query` request parameter `customerRef` - added the new optional `query` request parameter `productRef` - added `#/components/schemas/SdkPlanSnapshotDto` to the `purchases/items/planSnapshot` response property `allOf` list for the response status `200` - removed `#/components/schemas/PlanSnapshotDto` from the `purchases/items/planSnapshot` response property `allOf` list for the response status `200` - **2026-04-04** `88abf6f50f11` — 1 breaking, 1 warning, 3 info - the response property `purchases/items/planSnapshot` became optional for the status `200` - removed the optional property `purchases/items/isFreeTier` from the response with the `200` status - added the optional property `purchases/items/exchangeRate` to the response with the `200` status - added the optional property `purchases/items/metadata` to the response with the `200` status - added the optional property `purchases/items/originalAmount` to the response with the `200` status - **2026-03-25** `e0583a41987c` — 1 breaking, 23 info - the `purchases/items/` response's property type changed from no type to `object` for status `200` - added the optional property `purchases/items/autoRenew` to the response with the `200` status - added the optional property `purchases/items/billingCycle` to the response with the `200` status - added the optional property `purchases/items/cancellationReason` to the response with the `200` status - added the optional property `purchases/items/cancelledAt` to the response with the `200` status - added the optional property `purchases/items/endDate` to the response with the `200` status - added the optional property `purchases/items/isFreeTier` to the response with the `200` status - added the optional property `purchases/items/nextBillingDate` to the response with the `200` status - added the optional property `purchases/items/paidAt` to the response with the `200` status - added the optional property `purchases/items/productId` to the response with the `200` status - added the optional property `purchases/items/productName` to the response with the `200` status - added the optional property `purchases/items/usage` to the response with the `200` status - added the required property `purchases/items/amount` to the response with the `200` status - added the required property `purchases/items/createdAt` to the response with the `200` status - added the required property `purchases/items/currency` to the response with the `200` status - added the required property `purchases/items/customerEmail` to the response with the `200` status - added the required property `purchases/items/customerRef` to the response with the `200` status - added the required property `purchases/items/id` to the response with the `200` status - added the required property `purchases/items/isRecurring` to the response with the `200` status - added the required property `purchases/items/planSnapshot` to the response with the `200` status - added the required property `purchases/items/productRef` to the response with the `200` status - added the required property `purchases/items/reference` to the response with the `200` status - added the required property `purchases/items/startDate` to the response with the `200` status - added the required property `purchases/items/status` to the response with the `200` status - **2026-03-16** `9fd92a720973` — 13 breaking, 11 warning - the `purchases/items/` response's property type changed from `object` to no type for status `200` - removed the required property `purchases/items/amount` from the response with the `200` status - removed the required property `purchases/items/createdAt` from the response with the `200` status - removed the required property `purchases/items/currency` from the response with the `200` status - removed the required property `purchases/items/customerEmail` from the response with the `200` status - removed the required property `purchases/items/customerRef` from the response with the `200` status - removed the required property `purchases/items/id` from the response with the `200` status - removed the required property `purchases/items/isRecurring` from the response with the `200` status - removed the required property `purchases/items/planSnapshot` from the response with the `200` status - removed the required property `purchases/items/productRef` from the response with the `200` status - removed the required property `purchases/items/reference` from the response with the `200` status - removed the required property `purchases/items/startDate` from the response with the `200` status - removed the required property `purchases/items/status` from the response with the `200` status - removed the optional property `purchases/items/autoRenew` from the response with the `200` status - removed the optional property `purchases/items/billingCycle` from the response with the `200` status - removed the optional property `purchases/items/cancellationReason` from the response with the `200` status - removed the optional property `purchases/items/cancelledAt` from the response with the `200` status - removed the optional property `purchases/items/endDate` from the response with the `200` status - removed the optional property `purchases/items/isFreeTier` from the response with the `200` status - removed the optional property `purchases/items/nextBillingDate` from the response with the `200` status - removed the optional property `purchases/items/paidAt` from the response with the `200` status - removed the optional property `purchases/items/productId` from the response with the `200` status - removed the optional property `purchases/items/productName` from the response with the `200` status - removed the optional property `purchases/items/usage` from the response with the `200` status - **2026-03-14** `0e1cded2ee5d` — 1 info - added the media type `application/json` for the response with the status `200` - **2026-02-27** `9079f361f51c` — 1 info - endpoint added --- [Operation](https://skmtc.dev/solvapay/apis/solvapay-rest-api/docs/v1/sdk/purchases/get.md) · [API](https://skmtc.dev/solvapay/apis/solvapay-rest-api.md) · [Page](https://skmtc.dev/solvapay/apis/solvapay-rest-api/changes/v1/sdk/purchases/get)