---
title: "GET /subscriptions/{subscriptionId}/providers/Microsoft.Consumption/reservationRecommendations"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/reservationRecommendations"
tags: ["ReservationRecommendations"]
---

# GET /subscriptions/{subscriptionId}/providers/Microsoft.Consumption/reservationRecommendations

`GET /subscriptions/{subscriptionId}/providers/Microsoft.Consumption/reservationRecommendations`

List of recommendations for purchasing reserved instances.

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `$filter` string
- `api-version` string, required

## Response `200`

OK. The request has succeeded.

- ReservationRecommendationsListResult — Result of listing reservation recommendations.
  - `value` ReservationRecommendation[] — The list of reservation recommendations.
    - `id` string — Resource Id.
    - `name` string — Resource name.
    - `type` string — Resource type.
    - `tags` object — Resource tags.
    - `location` string — Resource location
    - `sku` string — Resource sku
    - `properties` ReservationRecommendationProperties — The properties of the reservation recommendation.
      - `lookBackPeriod` string — The number of days of usage to look back for recommendation.
      - `instanceFlexibilityRatio` integer — The instance Flexibility Ratio.
      - `instanceFlexibilityGroup` string — The instance Flexibility Group.
      - `normalizedSize` string — The normalized Size.
      - `recommendedQuantityNormalized` number — The recommended Quantity Normalized.
      - `meterId` string, uuid — The meter id (GUID)
      - `term` string — RI recommendations in one or three year terms.
      - `costWithNoReservedInstances` number — The total amount of cost without reserved instances.
      - `recommendedQuantity` number — Recommended quality for reserved instances.
      - `totalCostWithReservedInstances` number — The total amount of cost with reserved instances.
      - `netSavings` number — Total estimated savings with reserved instances.
      - `firstUsageDate` string, date-time — The usage date for looking back.
      - `scope` string — Shared or single recommendation.
      - `skuProperties` SkuProperty[] — List of sku properties
        - `name` string — The name of sku property.
        - `value` string — The value of sku property.
  - `nextLink` string — The link (url) to the next page of results.

## Other responses

- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.dev/azure/apis/consumptionmanagementclient.md) · [All operations](https://skmtc.dev/azure/apis/consumptionmanagementclient/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/consumptionmanagementclient/revisions/f34618e34e72/schema)
