---
title: "Changes to Propose a purchase of a plan"
method: POST
path: "/accounts/{account_id}/purchase_proposals"
---

# Changes to Propose a purchase of a plan

`POST /accounts/{account_id}/purchase_proposals`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 34 revisions.

- **2024-05-27** `2b8be460ec6a`: 3 info
- **2024-03-18** `3135bb8c67b3`: 3 info
- **2024-03-11** `cc0b10fb537e`: 10 warning, 8 info
- **2024-03-01** `6fb940b0dad9`: 16 breaking, 13 warning, 43 info
- **2023-11-03** `a6c96c5ec06e`: 6 breaking, 1 warning, 9 info
- **2023-10-16** `898bb5f2ce0c`: 8 info
- **2023-09-25** `ae3b70608528`: 3 info
- **2023-09-07** `cfabb13f9886`: 3 info
- **2023-09-02** `6b13f6f47735`: 25 breaking, 53 warning, 34 info

## Changes

- **2024-05-27** `2b8be460ec6a`: 3 info
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/licenseRateCards/items/usageCycle`
  - added the optional property `allOf[#/components/schemas/Purchase]/associationOverride/licenseRateCards/items/usageCycle` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/licenseRateCards/items/usageCycle` to the response with the `200` status
- **2024-03-18** `3135bb8c67b3`: 3 info
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/licenseRateCards/items/type`
  - added the optional property `allOf[#/components/schemas/Purchase]/associationOverride/licenseRateCards/items/type` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/licenseRateCards/items/type` to the response with the `200` status
- **2024-03-11** `cc0b10fb537e`: 10 warning, 8 info
  - added the new `PREPAID` enum value to the `allOf[#/components/schemas/Purchase]/associationOverride/billingEntitlementRateCards/items/invoiceTiming` response property for the response status `200`
  - added the new `PREPAID` enum value to the `allOf[#/components/schemas/Purchase]/associationOverride/creditGrantRateCards/items/invoiceTiming` response property for the response status `200`
  - added the new `PREPAID` enum value to the `allOf[#/components/schemas/Purchase]/associationOverride/fixedFeeRateCards/items/invoiceTiming` response property for the response status `200`
  - added the new `PREPAID` enum value to the `allOf[#/components/schemas/Purchase]/associationOverride/licenseRateCards/items/invoiceTiming` response property for the response status `200`
  - added the new `PREPAID` enum value to the `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/billingEntitlementRateCards/items/invoiceTiming` response property for the response status `200`
  - added the new `PREPAID` enum value to the `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/creditGrantRateCards/items/invoiceTiming` response property for the response status `200`
  - added the new `PREPAID` enum value to the `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/fixedFeeRateCards/items/invoiceTiming` response property for the response status `200`
  - added the new `PREPAID` enum value to the `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/licenseRateCards/items/invoiceTiming` response property for the response status `200`
  - added the new `PREPAID` enum value to the `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[subschema #2]/fixedFeeRateCards/items/invoiceTiming` response property for the response status `200`
  - added the new `PREPAID` enum value to the `allOf[#/components/schemas/Purchase]/type` response property for the response status `200`
  - added the new `PREPAID` enum value to the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/invoiceTiming`
  - added the new `PREPAID` enum value to the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/creditGrantRateCards/items/invoiceTiming`
  - added the new `PREPAID` enum value to the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/fixedFeeRateCards/items/invoiceTiming`
  - added the new `PREPAID` enum value to the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/licenseRateCards/items/invoiceTiming`
  - added the new `PREPAID` enum value to the request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/invoiceTiming`
  - added the new `PREPAID` enum value to the request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/creditGrantRateCards/items/invoiceTiming`
  - added the new `PREPAID` enum value to the request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/fixedFeeRateCards/items/invoiceTiming`
  - added the new `PREPAID` enum value to the request property `allOf[#/components/schemas/CreatePurchaseRequest]/type`
- **2024-03-01** `6fb940b0dad9`: 16 breaking, 13 warning, 43 info
  - added the new required request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/featureConfigs`
  - added the new required request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/featureId`
  - added the new required request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/invoiceTiming`
  - added the new required request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/ratePlan`
  - added the new required request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/rateValues`
  - added the new required request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/featureConfigs`
  - added the new required request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/featureId`
  - added the new required request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/invoiceTiming`
  - added the new required request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/ratePlan`
  - added the new required request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/rateValues`
  - the `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/` request property type changed from no type to `object`
  - the `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/` request property type changed from no type to `object`
  - the response property `allOf[#/components/schemas/Purchase]/pricePlanId` became optional for the status `200`
  - the response property `allOf[#/components/schemas/Purchase]/pricePlanVersion` became optional for the status `200`
  - the `allOf[#/components/schemas/Purchase]/associationOverride/billingEntitlementRateCards/items/` response's property type changed from no type to `object` for status `200`
  - the `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/billingEntitlementRateCards/items/` response's property type changed from no type to `object` for status `200`
  - removed `#/components/schemas/EntitlementRateCard, subschema #2` from the `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/` request property `allOf` list
  - removed `#/components/schemas/EntitlementRateCard, subschema #2` from the `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/` request property `allOf` list
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/entitlementRateCards`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/rateDetails`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/entitlementRateCards`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/rateDetails`
  - removed the optional property `allOf[#/components/schemas/Purchase]/associationOverride/entitlementRateCards` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/Purchase]/associationOverride/rateDetails` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/entitlementRateCards` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/rateDetails` from the response with the `200` status
  - added the new `WALLET` enum value to the `allOf[#/components/schemas/Purchase]/associationOverride/licenseRateCards/items/proratedRefundMode` response property for the response status `200`
  - added the new `WALLET` enum value to the `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/licenseRateCards/items/proratedRefundMode` response property for the response status `200`
  - added the new `WALLET_TOPUP` enum value to the `allOf[#/components/schemas/Purchase]/type` response property for the response status `200`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/displayName`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/recurrenceConfig`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/tag`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/creditGrantRateCards/items/rateDetails/currencySlabRateDetails/items/rateConfig`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/entitlementOverageRateCards/items/rateValues/items/rateConfig`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/licenseRateCards/items/rateValues/items/rateConfig`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/usageRateCards/items/rateValues/items/rateConfig`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/displayName`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/recurrenceConfig`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/tag`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/creditGrantRateCards/items/rateDetails/currencySlabRateDetails/items/rateConfig`
  - …32 more
- **2023-11-03** `a6c96c5ec06e`: 6 breaking, 1 warning, 9 info
  - the response property `allOf[#/components/schemas/Purchase]/associationOverride/entitlementOverageRateCards/items/displayName` became optional for the status `200`
  - the response property `allOf[#/components/schemas/Purchase]/associationOverride/pricingCycleConfig/startOffset` became optional for the status `200`
  - the response property `allOf[#/components/schemas/Purchase]/associationOverride/usageRateCards/items/displayName` became optional for the status `200`
  - the response property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/entitlementOverageRateCards/items/displayName` became optional for the status `200`
  - the response property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/pricingCycleConfig/startOffset` became optional for the status `200`
  - the response property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/usageRateCards/items/displayName` became optional for the status `200`
  - added the new `IN_PROGRESS` enum value to the `allOf[#/components/schemas/Purchase]/status` response property for the response status `200`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/licenseRateCards/items/config/maxQuantityBreachAction`
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/pricingCycleConfig/anniversaryCycle`
  - the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/entitlementOverageRateCards/items/displayName` became optional
  - the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/pricingCycleConfig/startOffset` became optional
  - the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/usageRateCards/items/displayName` became optional
  - added the optional property `allOf[#/components/schemas/Purchase]/associationOverride/licenseRateCards/items/config/maxQuantityBreachAction` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Purchase]/associationOverride/pricingCycleConfig/anniversaryCycle` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/licenseRateCards/items/config/maxQuantityBreachAction` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/pricingCycleConfig/anniversaryCycle` to the response with the `200` status
- **2023-10-16** `898bb5f2ce0c`: 8 info
  - the `type` request property default value `RECURRING` was removed
  - the `type` request property default value `RECURRING` was removed
  - the `type` request property default value `RECURRING` was removed
  - the `type` response's property default value `RECURRING` was removed for the status `200`
  - the `type` response's property default value `RECURRING` was removed for the status `200`
  - the `type` response's property default value `RECURRING` was removed for the status `200`
  - the `type` response's property default value `RECURRING` was removed for the status `200`
  - the `type` response's property default value `RECURRING` was removed for the status `200`
- **2023-09-25** `ae3b70608528`: 3 info
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/licenseRateCards/items/proratedRefundMode`
  - added the optional property `allOf[#/components/schemas/Purchase]/associationOverride/licenseRateCards/items/proratedRefundMode` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/licenseRateCards/items/proratedRefundMode` to the response with the `200` status
- **2023-09-07** `cfabb13f9886`: 3 info
  - added the new optional request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/entitlementOverageRateCards`
  - added the optional property `allOf[#/components/schemas/Purchase]/associationOverride/entitlementOverageRateCards` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/entitlementOverageRateCards` to the response with the `200` status
- **2023-09-02** `6b13f6f47735`: 25 breaking, 53 warning, 34 info
  - added `#/components/schemas/EntitlementRateCard, subschema #2` to the `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/` request property `allOf` list
  - added `#/components/schemas/EntitlementRateCard, subschema #2` to the `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/` request property `allOf` list
  - the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/pricingCycleConfig/startOffset` became required
  - the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/usageRateCards/items/displayName` became required
  - the request property `allOf[#/components/schemas/CreatePurchaseRequest]/pricePlanId` became required
  - removed the enum value `PREPAID` of the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/creditGrantRateCards/items/invoiceTiming`
  - removed the enum value `PREPAID` of the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/fixedFeeRateCards/items/invoiceTiming`
  - removed the enum value `PREPAID` of the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/licenseRateCards/items/invoiceTiming`
  - removed the enum value `PREPAID` of the request property `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/creditGrantRateCards/items/invoiceTiming`
  - removed the enum value `PREPAID` of the request property `allOf[#/components/schemas/CreatePurchaseRequest]/type`
  - removed the enum value `WALLET_TOPUP` of the request property `allOf[#/components/schemas/CreatePurchaseRequest]/type`
  - the `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/CreatePurchaseRequest]/purchasePlanOverride/billingEntitlementRateCards/items/` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/Purchase]/associationOverride/billingEntitlementRateCards/items/` response's property type changed from `object` to no type for status `200`
  - the `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/billingEntitlementRateCards/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `allOf[#/components/schemas/Purchase]/associationOverride/billingEntitlementRateCards/items/featureConfigs` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Purchase]/associationOverride/billingEntitlementRateCards/items/featureId` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Purchase]/associationOverride/billingEntitlementRateCards/items/invoiceTiming` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Purchase]/associationOverride/billingEntitlementRateCards/items/ratePlan` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Purchase]/associationOverride/billingEntitlementRateCards/items/rateValues` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/billingEntitlementRateCards/items/featureConfigs` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/billingEntitlementRateCards/items/featureId` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/billingEntitlementRateCards/items/invoiceTiming` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/billingEntitlementRateCards/items/ratePlan` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Purchase]/purchasePlanOverride/allOf[#/components/schemas/CreatePricePlanDetailsOverride]/billingEntitlementRateCards/items/rateValues` from the response with the `200` status
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/displayName`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/featureConfigs`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/featureId`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/invoiceTiming`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/ratePlan`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/rateValues`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/recurrenceConfig`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/billingEntitlementRateCards/items/tag`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/creditGrantRateCards/items/rateDetails/currencySlabRateDetails/items/rateConfig`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/entitlementOverageRateCards`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/licenseRateCards/items/config/maxQuantityBreachAction`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/licenseRateCards/items/proratedRefundMode`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/licenseRateCards/items/rateValues/items/rateConfig`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/licenseRateCards/items/type`
  - removed the request property `allOf[#/components/schemas/CreatePurchaseRequest]/associationOverride/licenseRateCards/items/usageCycle`
  - …72 more

---

[Operation](https://skmtc.dev/togaihq/apis/togai-apis/docs/accounts/:account_id/purchase_proposals/post.md) - [API](https://skmtc.dev/togaihq/apis/togai-apis.md) - [Page](https://skmtc.dev/togaihq/apis/togai-apis/changes/accounts/:account_id/purchase_proposals/post)