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

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

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

Lists scan results aggregated by a target resource.

## Request body

- object
  - `scanArn` string, required — The scan ARN.
  - `filterCriteria` object — The scan results aggregated by target resource 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.
    - `statusFilters` CisResultStatusFilter[] — The criteria's status filter.
      - `comparison` 'EQUALS', required — The comparison value of the CIS result status filter.
      - `value` 'PASSED' | 'FAILED' | 'SKIPPED', required — The value of the CIS result status 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.
    - `targetResourceIdFilters` CisStringFilter[] — The criteria's target resource 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.
    - `targetResourceTagFilters` TagFilter[] — The criteria's target resource tag filters.
      - `comparison` 'EQUALS', required — The tag filter comparison value.
      - `key` string, required — The tag filter key.
      - `value` string, required — The tag filter value.
    - `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.
    - `targetStatusFilters` CisTargetStatusFilter[] — The criteria's target status filters.
      - `comparison` 'EQUALS', required — The comparison value of the CIS target status filter.
      - `value` 'TIMED_OUT' | 'CANCELLED' | 'COMPLETED', required — The value of the CIS target status filter.
    - `targetStatusReasonFilters` CisTargetStatusReasonFilter[] — The criteria's target status reason filters.
      - `comparison` 'EQUALS', required — The comparison value of the CIS target status reason filter.
      - `value` 'SCAN_IN_PROGRESS' | 'UNSUPPORTED_OS' | 'SSM_UNMANAGED', required — The value of the CIS target status reason filter.
    - `failedChecksFilters` CisNumberFilter[] — The criteria's failed checks filters.
      - `upperInclusive` integer — The CIS number filter's upper inclusive.
      - `lowerInclusive` integer — The CIS number filter's lower inclusive.
  - `sortBy` 'RESOURCE_ID' | 'FAILED_COUNTS' | 'ACCOUNT_ID' | 'PLATFORM' | 'TARGET_STATUS' | 'TARGET_STATUS_REASON' — 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 a target resource to be returned in a single page of results.

## Response `200`

Success

- ListCisScanResultsAggregatedByTargetResourceResponse
  - `targetResourceAggregations` CisTargetResourceAggregation[] — The resource aggregations.
    - `scanArn` string, required — The scan ARN for the CIS target resource.
    - `targetResourceId` string — The ID of the target resource.
    - `accountId` string — The account ID for the CIS target resource.
    - `targetResourceTags` object — The tag for the target resource.
    - `statusCounts` object — The target resource 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 platform for the CIS target resource.
    - `targetStatus` 'TIMED_OUT' | 'CANCELLED' | 'COMPLETED' — The status of the target resource.
    - `targetStatusReason` 'SCAN_IN_PROGRESS' | 'UNSUPPORTED_OS' | 'SSM_UNMANAGED' — The reason for the target resource.
  - `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/versions/c51110c7cd43/schema)