---
title: "Changes to Get a purchase by reference"
method: GET
path: "/v1/sdk/purchases/{purchaseRef}"
---

# Changes to Get a purchase by reference

`GET /v1/sdk/purchases/{purchaseRef}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 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-04** `a30b6aef464d` — 2 info
- **2026-04-26** `60c2cd1caf83` — 1 info
- **2026-04-09** `7b327a22e3cb` — 1 warning, 1 info

## Changes

- **2026-08-13** `e356f6586bf2` — 4 warning
  - removed the optional property `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/billingCycle` from the response with the `200` status
  - removed the optional property `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/includedUnits` from the response with the `200` status
  - removed the optional property `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/meterRef` from the response with the `200` status
  - removed the optional property `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 `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/planType` from the response with the `200` status
  - removed the optional property `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/creditsPerUnit` from the response with the `200` status
  - removed the optional property `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/freeUnits` from the response with the `200` status
  - removed the optional property `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/limit` from the response with the `200` status
  - removed the optional property `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/limits` from the response with the `200` status
  - added the optional property `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/includedUnits` to the response with the `200` status
  - added the optional property `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/options` to the response with the `200` status
  - added the optional property `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/type` to the response with the `200` status
- **2026-07-30** `8578b7536a9f` — 2 breaking, 2 info
  - the response property `customerEmail` became optional for the status `200`
  - the response property `productRef` became optional for the status `200`
  - added the optional property `origin` to the response with the `200` status
  - added the optional property `requiresPayment` to the response with the `200` status
- **2026-07-04** `a30b6aef464d` — 2 info
  - the endpoint scheme security `SecretKey` was added to the API
  - the endpoint scheme security `bearer` was removed from the API
- **2026-04-26** `60c2cd1caf83` — 1 info
  - added the optional property `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 `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/pricePerUnit` from the response with the `200` status
  - added the optional property `planSnapshot/allOf[#/components/schemas/SdkPlanSnapshotDto]/creditsPerUnit` to the response with the `200` status

---

[Operation](https://skmtc.dev/solvapay/apis/solvapay-rest-api/docs/v1/sdk/purchases/:purchaseRef/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/:purchaseRef/get)