---
title: "Get List of Assessments"
method: GET
path: "/api/assessment/v2/assessments"
tags: ["Assessments"]
---

# Get List of Assessments

`GET /api/assessment/v2/assessments`

Use this API to retrieve a list of all assessments with basic assessment details. The response will include details such as the assessment ID, number, stage, result, and associated organization.

 > 🗒 Things to Know  
 >
 > - All assessments regardless of their stage are returned in the response by default.
 >
 > - The assessments can be filtered by stage using the `assessmentStatuses` query parameter. 
 >
 > - The `size` and `page` query parameters can be used to paginate the response (list of assessments). The `size` parameter defines the number of assessments to be returned in each page. The `page` parameter defines the page number. The first page and default `page` is page number 0. The `size` parameter is optional and default value is 20, but cannot exceed 2000. If you input a value greater than 2000, then 2000 will be used for the `size`.

## Query parameters

- `templateTypes` string[]
- `assessmentStatuses` string[]
- `assessmentArchivalState` 'ALL' | 'ARCHIVED' | 'NON_ARCHIVED'
- `page` integer
- `size` integer
- `sort` 'number,asc' | 'number,desc' | 'status,asc' | 'status,desc' | 'createdDate,asc' | 'createdDate,desc' | 'name,asc' | 'name,desc' | 'result,asc' | 'result,desc' | 'orgGroupName,asc' | 'orgGroupName,desc' | 'deadline,asc' | 'deadline,desc' | 'openRiskCount,asc' | 'openRiskCount,desc' | 'openInfoRequestCount,asc' | 'openInfoRequestCount,desc'

## Response `200`

OK

- PrivacyAutomationAssessmentAutomationPageAssessmentListViewBasicDto
  - `content` PrivacyAutomationAssessmentAutomationAssessmentListViewBasicDto
    - `assessmentId` string, uuid — Unique identifier for the assessment
    - `number` integer — Sequential number assigned to the assessment
    - `name` string — Name of the assessment
    - `status` 'Not Started' | 'In Progress' | 'Under Review' | 'Completed' — Current status of the assessment
    - `state` string — Current state of the assessment
    - `result` string
    - `resultId` string, uuid — Unique identifier for the assessment result
    - `resultName` string — Name of the assessment result
    - `orgGroupName` string — Name of the organization group to which the assessment belongs
    - `createDt` string, date-time — Date when the assessment was created
    - `tags` string[]
    - `templateName` string — Name of the template used for the assessment
    - `templateId` string, uuid — Unique identifier for the template
    - `templateRootVersionId` string, uuid — Root version identifier for the template
    - `primaryInventoryDetails` PrivacyAutomationAssessmentAutomationPrimaryInventoryDetails
      - `primaryInventoryName` string — Name of the primary inventory record
      - `primaryInventoryId` string, uuid — Unique identifier for the primary inventory record
      - `primaryInventoryNumber` integer — Sequential number assigned to the primary inventory record
    - `residualRiskScore` number — Risk score after controls have been applied
    - `openRiskCount` integer — Number of open risks associated with the assessment
    - `inherentRiskScore` number — Risk score before any controls are applied
    - `targetRiskScore` number — Target risk score to achieve
    - `lastUpdated` string, date-time — Date and time when the assessment was last updated
  - `page` PrivacyAutomationAssessmentAutomationAssessmentPage
    - `number` integer — Current page number (zero-based)
    - `size` integer — Number of items per page
    - `totalElements` integer — Total number of elements across all pages
    - `totalPages` integer — Total number of pages available

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500` — Internal Server Error

---

[API](https://skmtc.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)