---
title: "POST /providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}/savingsPlans/{savingsPlanId}/validate"
method: POST
path: "/providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}/savingsPlans/{savingsPlanId}/validate"
tags: ["SavingsPlanModels"]
---

# POST /providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}/savingsPlans/{savingsPlanId}/validate

`POST /providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}/savingsPlans/{savingsPlanId}/validate`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}/savingsPlans/{savingsPlanId}/validate`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Validate savings plan patch.

## Path parameters

- `savingsPlanOrderId` string, required
- `savingsPlanId` string, required

## Query parameters

- `api-version` string, required

## Request body

- SavingsPlanUpdateValidateRequest
  - `benefits` SavingsPlanUpdateRequestProperties[]
    - `displayName` string: Display name
    - `appliedScopeType` 'Single' | 'Shared' | 'ManagementGroup': Type of the Applied Scope.
    - `appliedScopeProperties` AppliedScopeProperties: Properties specific to applied scope type. Not required if not applicable.
      - `tenantId` string: Tenant ID where the benefit is applied.
      - `managementGroupId` string: Fully-qualified identifier of the management group where the benefit must be applied.
      - `subscriptionId` string: Fully-qualified identifier of the subscription.
      - `resourceGroupId` string: Fully-qualified identifier of the resource group.
      - `displayName` string: Display name
      - `benefitFilter` string: A filter string passed to downstream services to categorize and apply usage benefits to specific resource models. Expected format: "key/value" (e.g., "contractId/2025 H2CPU"). The value is not validated by BillingBenefits and is forwarded as-is.
    - `renew` boolean: Setting this to true will automatically purchase a new benefit on the expiration date time.
    - `renewProperties` RenewProperties
      - `purchaseProperties` PurchaseRequest
        - `sku` ResourceSku
          - `name` string
        - `properties` PurchaseRequestProperties
          - `displayName` string: Friendly name of the savings plan
          - `billingScopeId` string: Subscription that will be charged for purchasing the benefit
          - `term` 'P1M' | 'P1Y' | 'P3Y' | 'P5Y': Represent benefit term in ISO 8601 format.
          - `billingPlan` 'P1M': Represents the billing plan in ISO 8601 format. Required only for monthly billing plans.
          - `appliedScopeType` 'Single' | 'Shared' | 'ManagementGroup': Type of the Applied Scope.
          - `commitment` Commitment: Commitment towards the benefit.
            - `currencyCode` string: The ISO 4217 3-letter currency code for the currency used by this purchase record.
            - `amount` number, double
            - `grain` 'Hourly' | 'FullTerm' | 'Unknown': Grain.
          - `effectiveDateTime` string, date-time: DateTime of the savings plan starts providing benefit from.
          - `renew` boolean: Setting this to true will automatically purchase a new benefit on the expiration date time.
          - `renewAction` 'CreateNew' | 'RenewExisting': Represents the renewal action for a reservation to be a new purchase or existing renewal.
          - `appliedScopeProperties` AppliedScopeProperties: Properties specific to applied scope type. Not required if not applicable.
            - `tenantId` string: Tenant ID where the benefit is applied.
            - `managementGroupId` string: Fully-qualified identifier of the management group where the benefit must be applied.
            - `subscriptionId` string: Fully-qualified identifier of the subscription.
            - `resourceGroupId` string: Fully-qualified identifier of the resource group.
            - `displayName` string: Display name
            - `benefitFilter` string: A filter string passed to downstream services to categorize and apply usage benefits to specific resource models. Expected format: "key/value" (e.g., "contractId/2025 H2CPU"). The value is not validated by BillingBenefits and is forwarded as-is.

## Response `200`

Azure operation completed successfully.

- SavingsPlanValidateResponse
  - `benefits` SavingsPlanValidResponseProperty[]
    - `valid` boolean: Indicates if the provided input was valid
    - `reasonCode` string: Failure reason code if the provided input was invalid
    - `reason` string: Failure reason if the provided input was invalid
  - `nextLink` string: Url to get the next page.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-07-13** (2022-11-01) `524c785862c5`: 1 breaking
  - added the new required `query` request parameter `api-version`
- **2026-07-13** (2022-11-01) `a1c0ddb43231`: 1 warning, 2 info
  - deleted the `query` request parameter `api-version`
  - api tag `SavingsPlanModels` added
  - api tag `Savings plan` removed
- **2026-07-13** (2022-11-01) `47d61aaf3262`: 1 breaking, 2 info
  - added the new required `query` request parameter `api-version`
  - api tag `Savings plan` added
  - api tag `SavingsPlanModels` removed
- **2022-11-21** (2022-11-01) `af51fc15a1bc`: 1 info
  - api operation id `SavingsPlanUpdate_Validate` removed and replaced with `SavingsPlan_ValidateUpdate`
- **2022-11-14** (2022-11-01) `2a40ceec2c00`: 1 breaking, 3 info
  - added the new required `query` request parameter `api-version`
  - api operation id `SavingsPlan_ValidateUpdate` removed and replaced with `SavingsPlanUpdate_Validate`
  - api tag `Savings plan` added
  - api tag `SavingsPlanModels` removed

[Operation history](https://skmtc.dev/azure/apis/billingbenefits-microsoft-billingbenefits/changes/providers/Microsoft.BillingBenefits/savingsPlanOrders/:savingsPlanOrderId/savingsPlans/:savingsPlanId/validate/post.md)

---

[API](https://skmtc.dev/azure/apis/billingbenefits-microsoft-billingbenefits.md) - [All operations](https://skmtc.dev/azure/apis/billingbenefits-microsoft-billingbenefits/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/billingbenefits-microsoft-billingbenefits/revisions/524c785862c5?raw)
