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

# GET /providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}/savingsPlans

`GET /providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}/savingsPlans`

## Request

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

List savings plans in an order.

## Path parameters

- `savingsPlanOrderId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

Azure operation completed successfully.

- SavingsPlanModelList: Paged collection of SavingsPlanModel items
  - `value` SavingsPlanModel[], required: The SavingsPlanModel items on this page
    - `id` string, arm-id: Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    - `name` string: The name of the resource
    - `type` string: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    - `systemData` SystemData: Metadata pertaining to creation and last modification of the resource.
      - `createdBy` string: The identity that created the resource.
      - `createdByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that created the resource.
      - `createdAt` string, date-time: The timestamp of resource creation (UTC).
      - `lastModifiedBy` string: The identity that last modified the resource.
      - `lastModifiedByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that last modified the resource.
      - `lastModifiedAt` string, date-time: The timestamp of resource last modification (UTC)
    - `properties` SavingsPlanModelProperties: Savings plan properties
      - `displayName` string: Display name
      - `provisioningState` 'Creating' | 'PendingBilling' | 'ConfirmedBilling' | 'Created' | 'Succeeded' | 'Cancelled' | 'Expired' | 'Failed': Provisioning state
      - `displayProvisioningState` string: The provisioning state of the savings plan for display, e.g. Succeeded
      - `billingScopeId` string: Subscription that will be charged for purchasing the benefit
      - `billingProfileId` string, arm-id: Fully-qualified identifier of the billing profile where the benefit is applied. Present only for Field-led or Customer-led customers.
      - `customerId` string, arm-id: Fully-qualified identifier of the customer where the savings plan is applied. Present only for Partner-led customers.
      - `billingAccountId` string, arm-id: Fully-qualified identifier of the billing account where the benefit is applied. Present only for Enterprise Agreement customers.
      - `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.
      - `userFriendlyAppliedScopeType` string: The applied scope type of the savings plan for display, e.g. Shared
      - `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.
      - `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.
      - `expiryDateTime` string, date-time: Expiry date time
      - `purchaseDateTime` string, date-time: Date time when the savings plan was purchased
      - `benefitStartTime` string, date-time: This is the DateTime when the savings plan benefit started.
      - `extendedStatusInfo` ExtendedStatusInfo
        - `statusCode` string: Status code providing additional information.
        - `message` string: The message giving detailed information about the status code.
      - `renew` boolean: Setting this to true will automatically purchase a new benefit on the expiration date time.
      - `utilization` Utilization: Savings plan utilization
        - `trend` string: The number of days trend for a savings plan
        - `aggregates` UtilizationAggregates[]: The array of aggregates of a savings plan's utilization
          - `grain` number, float: The grain of the aggregate
          - `grainUnit` string: The grain unit of the aggregate
          - `value` number, float: The aggregate value
          - `valueUnit` string: The aggregate value unit
      - `renewSource` string: SavingsPlan Id of the SavingsPlan from which this SavingsPlan is renewed.
      - `renewDestination` string: SavingsPlan Id of the SavingsPlan which is purchased because of renew.
      - `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.
              - …
            - `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.
              - …
    - `sku` ResourceSku, required
      - `name` string
  - `nextLink` string, uri: The link to the next page of items

## 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 `SavingsPlansInOrder_List` removed and replaced with `SavingsPlan_List`
- **2022-11-14** (2022-11-01) `2a40ceec2c00`: 1 breaking, 3 info
  - added the new required `query` request parameter `api-version`
  - api operation id `SavingsPlan_List` removed and replaced with `SavingsPlansInOrder_List`
  - 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/get.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)
