---
title: "GET /v1/checks"
method: GET
path: "/v1/checks"
---

# GET /v1/checks

`GET /v1/checks`

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

## Query parameters

- `nextToken` string
- `maxResults` integer
- `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'
- `language` 'en' | 'ja' | 'zh' | 'fr' | 'de' | 'ko' | 'zh_TW' | 'it' | 'es' | 'pt_BR' | 'id'

## Response `200`

Success

- ListChecksResponse
  - `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.
  - `checkSummaries` CheckSummary[], required — The list of Checks
    - `id` string, required — The unique identifier of the AWS Trusted Advisor Check
    - `arn` string, required — The ARN of the AWS Trusted Advisor Check
    - `name` string, required — The name of the AWS Trusted Advisor Check
    - `description` string, required — A description of what the AWS Trusted Advisor Check is monitoring
    - `pillars` RecommendationPillar[], required — The Recommendation pillars that the AWS Trusted Advisor Check falls under
    - `awsServices` RecommendationAwsService[], required — The AWS Services that the Check applies to
    - `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
    - `metadata` object, required — The column headings for the metadata returned in the resource

## 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)