---
title: "GET /assessments"
method: GET
path: "/assessments"
---

# GET /assessments

`GET /assessments`

Returns a list of current and past assessments from Audit Manager.

## Query parameters

- `status` 'ACTIVE' | 'INACTIVE'
- `nextToken` string
- `maxResults` integer — Max results in the page.

## Response `200`

Success

- ListAssessmentsResponse
  - `assessmentMetadata` AssessmentMetadataItem[] — The metadata that's associated with the assessment.
    - `name` string — The name of the assessment.
    - `id` string — The unique identifier for the assessment.
    - `complianceType` string — The name of the compliance standard that's related to the assessment, such as PCI-DSS.
    - `status` 'ACTIVE' | 'INACTIVE' — The current status of the assessment.
    - `roles` Role[] — The roles that are associated with the assessment.
      - `roleType` 'PROCESS_OWNER' | 'RESOURCE_OWNER', required — <p> The type of customer persona. </p> <note> <p>In <code>CreateAssessment</code>, <code>roleType</code> can only be <code>PROCESS_OWNER</code>. </p> <p>In <code>UpdateSettings</code>, <code>roleType</code> can only be <code>PROCESS_OWNER</code>.</p> <p>In <code>BatchCreateDelegationByAssessment</code>, <code>roleType</code> can only be <code>RESOURCE_OWNER</code>.</p> </note>
      - `roleArn` string, required — The Amazon Resource Name (ARN) of the IAM role.
    - `delegations` Delegation[] — The delegations that are associated with the assessment.
      - `id` string — The unique identifier for the delegation.
      - `assessmentName` string — The name of the assessment that's associated with the delegation.
      - `assessmentId` string — The identifier for the assessment that's associated with the delegation.
      - `status` 'IN_PROGRESS' | 'UNDER_REVIEW' | 'COMPLETE' — The status of the delegation.
      - `roleArn` string — The Amazon Resource Name (ARN) of the IAM role.
      - `roleType` 'PROCESS_OWNER' | 'RESOURCE_OWNER' — <p> The type of customer persona. </p> <note> <p>In <code>CreateAssessment</code>, <code>roleType</code> can only be <code>PROCESS_OWNER</code>. </p> <p>In <code>UpdateSettings</code>, <code>roleType</code> can only be <code>PROCESS_OWNER</code>.</p> <p>In <code>BatchCreateDelegationByAssessment</code>, <code>roleType</code> can only be <code>RESOURCE_OWNER</code>.</p> </note>
      - `creationTime` string, date-time — Specifies when the delegation was created.
      - `lastUpdated` string, date-time — Specifies when the delegation was last updated.
      - `controlSetId` string — The identifier for the control set that's associated with the delegation.
      - `comment` string — The comment that's related to the delegation.
      - `createdBy` string — The user or role that created the delegation.
    - `creationTime` string, date-time — Specifies when the assessment was created.
    - `lastUpdated` string, date-time — The time of the most recent update.
  - `nextToken` string — The pagination token that's used to fetch the next set of results.

## Other responses

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

---

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