---
title: "POST /#X-Amz-Target=CostOptimizationHubService.ListRecommendationSummaries"
method: POST
path: "/#X-Amz-Target=CostOptimizationHubService.ListRecommendationSummaries"
---

# POST /#X-Amz-Target=CostOptimizationHubService.ListRecommendationSummaries

`POST /#X-Amz-Target=CostOptimizationHubService.ListRecommendationSummaries`

Returns a concise representation of savings estimates for resources. Also returns de-duped savings across different types of recommendations.

The following filters are not supported for this API: `recommendationIds`, `resourceArns`, and `resourceIds`.

## Headers

- `X-Amz-Target` 'CostOptimizationHubService.ListRecommendationSummaries', required

## Request body

- ListRecommendationSummariesRequest
  - `filter` Filter — Describes a filter that returns a more specific list of recommendations. Filters recommendations by different dimensions.
    - `restartNeeded` boolean — Whether or not implementing the recommendation requires a restart.
    - `rollbackPossible` boolean — Whether or not implementing the recommendation can be rolled back.
    - `implementationEfforts` ImplementationEffort[] — The effort required to implement the recommendation.
    - `accountIds` AccountId[] — The account to which the recommendation applies.
    - `regions` String[] — The Amazon Web Services Region of the resource.
    - `resourceTypes` ResourceType[] — The resource type of the recommendation.
    - `actionTypes` ActionType[] — The type of action you can take by adopting the recommendation.
    - `tags` Tag[] — A list of tags assigned to the recommendation.
      - `key` string — The key that's associated with the tag.
      - `value` string — The value that's associated with the tag.
    - `resourceIds` String[] — The resource ID of the recommendation.
    - `resourceArns` String[] — The Amazon Resource Name (ARN) of the recommendation.
    - `recommendationIds` String[] — The IDs for the recommendations.
  - `groupBy` string, required — The grouping of recommendations by a dimension.
  - `maxResults` integer — The maximum number of recommendations to be returned for the request.
  - `metrics` SummaryMetrics[] — Additional metrics to be returned for the request. The only valid value is <code>savingsPercentage</code>.
  - `nextToken` string — The token to retrieve the next set of results.

## Response `200`

Success

- ListRecommendationSummariesResponse
  - `estimatedTotalDedupedSavings` number, double — The total overall savings for the aggregated view.
  - `items` RecommendationSummary[] — A list of all savings recommendations.
    - `group` string — The grouping of recommendations.
    - `estimatedMonthlySavings` number, double — The estimated total savings resulting from modifications, on a monthly basis.
    - `recommendationCount` integer — The total number of instance recommendations.
  - `groupBy` string — The dimension used to group the recommendations by.
  - `currencyCode` string — The currency code used for the recommendation.
  - `metrics` object — The results or descriptions for the additional metrics, based on whether the metrics were or were not requested.
    - `savingsPercentage` string — <p>The savings percentage based on your Amazon Web Services spend over the past 30 days.</p> <note> <p>Savings percentage is only supported when filtering by Region, account ID, or tags.</p> </note>
  - `nextToken` string — The token to retrieve the next set of results.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException
- `482` — AccessDeniedException
- `483` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/cost-optimization-hub.md) · [All operations](https://skmtc.net/aws/apis/cost-optimization-hub/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/cost-optimization-hub/versions/fb30b7c46a54/schema)