---
title: "GET /v1/organization-recommendations"
method: GET
path: "/v1/organization-recommendations"
---

# GET /v1/organization-recommendations

`GET /v1/organization-recommendations`

List a filterable set of Recommendations within an Organization. This API only supports prioritized recommendations and provides global priority recommendations, eliminating the need to call the API in each AWS Region.

## Query parameters

- `nextToken` string
- `maxResults` integer
- `type` 'standard' | 'priority'
- `status` 'ok' | 'warning' | 'error'
- `pillar` 'cost_optimizing' | 'performance' | 'security' | 'service_limits' | 'fault_tolerance' | 'operational_excellence'
- `awsService` string
- `source` 'aws_config' | 'compute_optimizer' | 'cost_explorer' | 'lse' | 'manual' | 'pse' | 'rds' | 'resilience' | 'resilience_hub' | 'security_hub' | 'stir' | 'ta_check' | 'well_architected' | 'cost_optimization_hub'
- `checkIdentifier` string
- `afterLastUpdatedAt` string, date-time
- `beforeLastUpdatedAt` string, date-time

## Response `200`

Success

- ListOrganizationRecommendationsResponse
  - `nextToken` string — The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
  - `organizationRecommendationSummaries` OrganizationRecommendationSummary[], required — The list of Recommendations
    - `id` string, required — The ID which identifies where the Recommendation was produced
    - `type` 'standard' | 'priority', required — Whether the Recommendation was automated or generated by AWS Trusted Advisor Priority
    - `checkArn` string — The AWS Trusted Advisor Check ARN that relates to the Recommendation
    - `status` 'ok' | 'warning' | 'error', required — The status of the Recommendation
    - `lifecycleStage` 'in_progress' | 'pending_response' | 'dismissed' | 'resolved' — The lifecycle stage from AWS Trusted Advisor Priority
    - `pillars` RecommendationPillar[], required — The Pillars that the Recommendation is optimizing
    - `source` 'aws_config' | 'compute_optimizer' | 'cost_explorer' | 'lse' | 'manual' | 'pse' | 'rds' | 'resilience' | 'resilience_hub' | 'security_hub' | 'stir' | 'ta_check' | 'well_architected' | 'cost_optimization_hub', required — The source of the Recommendation
    - `awsServices` RecommendationAwsService[] — The AWS Services that the Recommendation applies to
    - `name` string, required — The name of the AWS Trusted Advisor Recommendation
    - `resourcesAggregates` object, required — An aggregation of all resources
      - `okCount` integer, required — The number of AWS resources that were flagged to be OK according to the Trusted Advisor check
      - `warningCount` integer, required — The number of AWS resources that were flagged to have warning according to the Trusted Advisor check
      - `errorCount` integer, required — The number of AWS resources that were flagged to have errors according to the Trusted Advisor check
      - `excludedCount` integer — The number of AWS resources belonging to this Trusted Advisor check that were excluded by the customer
    - `pillarSpecificAggregates` object — The pillar aggregations for cost savings
      - `costOptimizing` object — Cost optimizing aggregates
        - `estimatedMonthlySavings` number, double, required — The estimated monthly savings
        - `estimatedPercentMonthlySavings` number, double, required — The estimated percently monthly savings
    - `createdAt` string, date-time — When the Recommendation was created, if created by AWS Trusted Advisor Priority
    - `lastUpdatedAt` string, date-time — When the Recommendation was last updated
    - `arn` string, required — The ARN of the Recommendation

## Other responses

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

---

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