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

# Get List of Assigned Assessments

`GET /api/assessment/v2/assessments/assigned`

## Request

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

Use this API to retrieve assessments assigned to the current user. The response includes assessments where the current user is an approver, respondent, or risk owner. The response returns a list of assessments up to the specified `limit`, along with `totalCount` and `hasMore` values to indicate whether additional assessments are available.

> 🗒 Things to Know
>
> - This endpoint only returns assessments assigned to the current user and cannot be used to retrieve assessments assigned to another user.

## Query parameters

- `templateTypes` string[]
- `text` string
- `filter` string
- `limit` integer
- `sort` string[]

## Response `200`

OK

- PrivacyAutomationAssessmentAutomationAssessmentMcpListResponseAssessmentSSPListDto
  - `content` PrivacyAutomationAssessmentAutomationAssessmentSSPListDto[]: The assessment data content, capped at the requested limit
    - `assessmentId` string, uuid
    - `number` integer
    - `name` string
    - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'UNDER_REVIEW' | 'COMPLETED'
    - `approver` string
    - `approvers` PrivacyAutomationAssessmentAutomationBasicUserEntityDetail[]
      - `id` string, uuid: Unique identifier of the user
      - `fullName` string: Full name of the user
      - `email` string: Email address of the user
      - `deleted` boolean: Flag indicating whether the user has been deleted
      - `assigneeType` string: Type of assignee (e.g., USER, GROUP)
    - `deadline` string, date-time
    - `primaryInventoryName` string
    - `primaryInventoryNumber` string: Primary inventory record numbers, separated by '; ' when multiple primary records are linked to the assessment
    - `workflowId` string, uuid
    - `workflowStageId` string, uuid
    - `workflowName` string
    - `approvalStageName` string
    - `badgeColor` string
    - `createdBy` string, uuid
    - `deletedBy` string, uuid
    - `completedBy` string, uuid
    - `recordAdminId` string, uuid
  - `totalCount` integer: Total number of assessments matching the given criteria, independent of the limit applied
  - `hasMore` boolean: Whether more assessments exist beyond the ones returned in content, i.e. totalCount > content.size()

## 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)