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

# Get List of Assessments

`GET /api/assessment/v2/assessments`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/assessment/v2/assessments`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `ASSESSMENT_READ`, `ASSESSMENT`

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` string[]

## 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` PrivacyAutomationAssessmentAutomationAssessmentPrimaryInventoryDetailsDto
      - `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.dev/onetrust/apis/privacy-automation-assessment-automation.md) - [All operations](https://skmtc.dev/onetrust/apis/privacy-automation-assessment-automation/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/privacy-automation-assessment-automation/revisions/fbdf0c71bfe5?raw)