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

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

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

Returns a list of recommendations.

## Headers

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

## Request body

- ListRecommendationsRequest
  - `filter` object — The constraints that you want all returned recommendations to match.
    - `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.
  - `orderBy` object — The ordering of recommendations by a dimension.
    - `dimension` string — Sorts by dimension values.
    - `order` 'Asc' | 'Desc' — The order that's used to sort the data.
  - `includeAllRecommendations` boolean — List of all recommendations for a resource, or a single recommendation if de-duped by <code>resourceId</code>.
  - `maxResults` integer — The maximum number of recommendations that are returned for the request.
  - `nextToken` string — The token to retrieve the next set of results.

## Response `200`

Success

- ListRecommendationsResponse
  - `items` Recommendation[] — List of all savings recommendations.
    - `recommendationId` string — The ID for the recommendation.
    - `accountId` string — The account to which the recommendation applies.
    - `region` string — The Amazon Web Services Region of the resource.
    - `resourceId` string — The resource ID for the recommendation.
    - `resourceArn` string — The Amazon Resource Name (ARN) for the recommendation.
    - `currentResourceType` string — The current resource type.
    - `recommendedResourceType` string — The recommended resource type.
    - `estimatedMonthlySavings` number, double — The estimated monthly savings amount for the recommendation.
    - `estimatedSavingsPercentage` number, double — The estimated savings percentage relative to the total cost over the cost calculation lookback period.
    - `estimatedMonthlyCost` number, double — The estimated monthly cost of the current resource. For Reserved Instances and Savings Plans, it refers to the cost for eligible usage.
    - `currencyCode` string — The currency code used for the recommendation.
    - `implementationEffort` string — The effort required to implement the recommendation.
    - `restartNeeded` boolean — Whether or not implementing the recommendation requires a restart.
    - `actionType` string — The type of tasks that can be carried out by this action.
    - `rollbackPossible` boolean — Whether or not implementing the recommendation can be rolled back.
    - `currentResourceSummary` string — Describes the current resource.
    - `recommendedResourceSummary` string — Describes the recommended resource.
    - `lastRefreshTimestamp` string, date-time — The time when the recommendation was last generated.
    - `recommendationLookbackPeriodInDays` integer — The lookback period that's used to generate the recommendation.
    - `source` 'ComputeOptimizer' | 'CostExplorer' — The source of 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.
  - `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)