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

# POST /cis/scan/list

`POST /cis/scan/list`

Returns a CIS scan list.

## Request body

- object
  - `filterCriteria` object — A list of CIS scans filter criteria.
    - `scanNameFilters` CisStringFilter[] — The list of scan name 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 list of 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.
    - `targetResourceIdFilters` CisStringFilter[] — The list of 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.
    - `scanStatusFilters` CisScanStatusFilter[] — The list of scan status filters.
      - `comparison` 'EQUALS', required — The filter comparison value.
      - `value` 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'IN_PROGRESS', required — The filter value.
    - `scanAtFilters` CisDateFilter[] — The list of scan at filters.
      - `earliestScanStartTime` string, date-time — The CIS date filter's earliest scan start time.
      - `latestScanStartTime` string, date-time — The CIS date filter's latest scan start time.
    - `scanConfigurationArnFilters` CisStringFilter[] — The list of scan configuration ARN 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.
    - `scanArnFilters` CisStringFilter[] — The list of scan ARN 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.
    - `scheduledByFilters` CisStringFilter[] — The list of scheduled by 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.
    - `failedChecksFilters` CisNumberFilter[] — The list of failed checks filters.
      - `upperInclusive` integer — The CIS number filter's upper inclusive.
      - `lowerInclusive` integer — The CIS number filter's lower inclusive.
    - `targetAccountIdFilters` CisStringFilter[] — The list of target 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.
  - `detailLevel` 'ORGANIZATION' | 'MEMBER' — The detail applied to the CIS scan.
  - `sortBy` 'STATUS' | 'SCHEDULED_BY' | 'SCAN_START_DATE' | 'FAILED_CHECKS' — The CIS scans sort by order.
  - `sortOrder` 'ASC' | 'DESC' — The CIS scans 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 results to be returned.

## Response `200`

Success

- ListCisScansResponse
  - `scans` CisScan[] — The CIS scans.
    - `scanArn` string, required — The CIS scan's ARN.
    - `scanConfigurationArn` string, required — The CIS scan's configuration ARN.
    - `status` 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'IN_PROGRESS' — The CIS scan's status.
    - `scanName` string — The the name of the scan configuration that's associated with this scan.
    - `scanDate` string, date-time — The CIS scan's date.
    - `failedChecks` integer — The CIS scan's failed checks.
    - `totalChecks` integer — The CIS scan's total checks.
    - `targets` object — The CIS scan's targets.
      - `accountIds` AccountId[] — The CIS target account ids.
      - `targetResourceTags` object — The CIS target resource tags.
    - `scheduledBy` string — The account or organization that schedules the CIS scan.
    - `securityLevel` 'LEVEL_1' | 'LEVEL_2' — The security level for the CIS scan. Security level refers to the Benchmark levels that CIS assigns to a profile.
  - `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)