---
title: "POST /cis/scan-result/check/list"
method: POST
path: "/cis/scan-result/check/list"
---

# POST /cis/scan-result/check/list

`POST /cis/scan-result/check/list`

Lists scan results aggregated by checks.

## Request body

- object
  - `scanArn` string, required — The scan ARN.
  - `filterCriteria` object — The scan results aggregated by checks filter criteria.
    - `accountIdFilters` CisStringFilter[] — The criteria's account ID filters.
      - `comparison` 'EQUALS' | 'PREFIX' | 'NOT_EQUALS', required — The comparison value of the CIS string filter.
      - `value` string, required — The value of the CIS string filter.
    - `checkIdFilters` CisStringFilter[] — The criteria's check ID filters.
      - `comparison` 'EQUALS' | 'PREFIX' | 'NOT_EQUALS', required — The comparison value of the CIS string filter.
      - `value` string, required — The value of the CIS string filter.
    - `titleFilters` CisStringFilter[] — The criteria's title filters.
      - `comparison` 'EQUALS' | 'PREFIX' | 'NOT_EQUALS', required — The comparison value of the CIS string filter.
      - `value` string, required — The value of the CIS string filter.
    - `platformFilters` CisStringFilter[] — The criteria's platform filters.
      - `comparison` 'EQUALS' | 'PREFIX' | 'NOT_EQUALS', required — The comparison value of the CIS string filter.
      - `value` string, required — The value of the CIS string filter.
    - `failedResourcesFilters` CisNumberFilter[] — The criteria's failed resources filters.
      - `upperInclusive` integer — The CIS number filter's upper inclusive.
      - `lowerInclusive` integer — The CIS number filter's lower inclusive.
    - `securityLevelFilters` CisSecurityLevelFilter[] — The criteria's security level filters.
      - `comparison` 'EQUALS', required — The CIS security filter comparison value.
      - `value` 'LEVEL_1' | 'LEVEL_2', required — The CIS security filter value.
  - `sortBy` 'CHECK_ID' | 'TITLE' | 'PLATFORM' | 'FAILED_COUNTS' | 'SECURITY_LEVEL' — The sort by order.
  - `sortOrder` 'ASC' | 'DESC' — The sort order.
  - `nextToken` string — The pagination token from a previous request that's used to retrieve the next page of results.
  - `maxResults` integer — The maximum number of scan results aggregated by checks to be returned in a single page of results.

## Response `200`

Success

- ListCisScanResultsAggregatedByChecksResponse
  - `checkAggregations` CisCheckAggregation[] — The check aggregations.
    - `scanArn` string, required — The scan ARN for the CIS check scan ARN.
    - `checkId` string — The check ID for the CIS check.
    - `title` string — The CIS check title.
    - `checkDescription` string — The description for the CIS check.
    - `level` 'LEVEL_1' | 'LEVEL_2' — The CIS check level.
    - `accountId` string — The account ID for the CIS check.
    - `statusCounts` object — The CIS check status counts.
      - `failed` integer — The number of checks that failed.
      - `skipped` integer — The number of checks that were skipped.
      - `passed` integer — The number of checks that passed.
    - `platform` string — The CIS check platform.
  - `nextToken` string — The pagination token from a previous request that's used to retrieve the next page of results.

## Other responses

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

---

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