v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14119667.3 KB

List a filterable set of Recommendations. This API provides global recommendations, eliminating the need to call the API in each AWS Region.

get/v1/recommendations

Query parameters

nextTokenstring

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.

maxResultsinteger

The maximum number of results to return per page.

type'standard' | 'priority'

The type of the Recommendation

status'ok' | 'warning' | 'error'

The status of the Recommendation

pillar'cost_optimizing' | 'performance' | 'security' | 'service_limits' | 'fault_tolerance' | 'operational_excellence'

The pillar of the Recommendation

awsServicestring

The aws service associated with the Recommendation

source'aws_config' | 'compute_optimizer' | 'cost_explorer' | 'lse' | 'manual' | 'pse' | 'rds' | 'resilience' | 'resilience_hub' | 'security_hub' | 'stir' | 'ta_check' | 'well_architected' | 'cost_optimization_hub'

The source of the Recommendation

checkIdentifierstring

The check identifier of the Recommendation

afterLastUpdatedAtstring date-time

After the last update of the Recommendation

beforeLastUpdatedAtstring date-time

Before the last update of the Recommendation

language'en' | 'ja' | 'zh' | 'fr' | 'de' | 'ko' | 'zh_TW' | 'it' | 'es' | 'pt_BR' | 'id'

The ISO 639-1 code for the language that you want your recommendations to appear in.

Response

Success

nextTokenstring

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.