---
title: "POST /codesecurity/scan-configuration/get"
method: POST
path: "/codesecurity/scan-configuration/get"
---

# POST /codesecurity/scan-configuration/get

`POST /codesecurity/scan-configuration/get`

Retrieves information about a code security scan configuration.

## Request body

- object
  - `scanConfigurationArn` string, required — arn:aws:inspector2:<region>:<account-id>:owner/<owner-id>/codesecurity-configuration/<uuid>

## Response `200`

Success

- GetCodeSecurityScanConfigurationResponse
  - `scanConfigurationArn` string — The Amazon Resource Name (ARN) of the scan configuration.
  - `name` string — The name of the scan configuration.
  - `configuration` object — The configuration settings for the code security scan.
    - `periodicScanConfiguration` object — Configuration settings for periodic scans that run on a scheduled basis.
      - `frequency` 'WEEKLY' | 'MONTHLY' | 'NEVER' — <p>The frequency at which periodic scans are performed (such as weekly or monthly).</p> <p>If you don't provide the <code>frequencyExpression</code> Amazon Inspector chooses day for the scan to run. If you provide the <code>frequencyExpression</code>, the schedule must match the specified <code>frequency</code>.</p>
      - `frequencyExpression` string — The schedule expression for periodic scans, in cron format.
    - `continuousIntegrationScanConfiguration` object — Configuration settings for continuous integration scans that run automatically when code changes are made.
      - `supportedEvents` ContinuousIntegrationScanEvent[], required — The repository events that trigger continuous integration scans, such as pull requests or commits.
    - `ruleSetCategories` RuleSetCategory[], required — The categories of security rules to be applied during the scan.
  - `level` 'ORGANIZATION' | 'ACCOUNT' — The security level for the scan configuration.
  - `scopeSettings` object — The scope settings that define which repositories will be scanned. If the <code>ScopeSetting</code> parameter is <code>ALL</code> the scan configuration applies to all existing and future projects imported into Amazon Inspector.
    - `projectSelectionScope` 'ALL' — The scope of projects to be selected for scanning within the integrated repositories. Setting the value to <code>ALL</code> applies the scope settings to all existing and future projects imported into Amazon Inspector.
  - `createdAt` string, date-time — The timestamp when the scan configuration was created.
  - `lastUpdatedAt` string, date-time — The timestamp when the scan configuration was last updated.
  - `tags` object — The tags associated with the scan configuration.

## Other responses

- `480` — AccessDeniedException
- `481` — ValidationException
- `482` — ThrottlingException
- `483` — ResourceNotFoundException
- `484` — 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)