---
title: "List assessments"
method: GET
path: "/assessments"
tags: ["Assessments"]
deprecated: true
---

# List assessments

`GET /assessments`

> **Deprecated.**

This API version is deprecated and will be removed in future releases. We recommend you to use the V2 version of this API, which is available at `/rest/assessments/v2`.
Returns a list of assessments that you created; and the assessments that you are permitted to view. The assessments are sorted by `lastModifiedOn` in descending order, with the most recent first.

## Query parameters

- `name` string
- `status` string
- `lastModifiedFrom` string, date-time
- `lastModifiedUntil` string, date-time
- `templateId` string, uuid
- `templateVersion` string
- `assetId` string, uuid
- `limit` integer
- `cursor` string

## Response `200`

Example of a response for listing assessments.

- PagedAssessments — A page object containing assessments.
  - `nextCursor` string — The cursor pointing to the next page. If the cursor is missing, there are no additional pages of resources available after the current one.
  - `results` Assessment[], required
    - `id` string, uuid, required — The ID of the assessment.
    - `originAssessment` OriginAssessment — An object that represents the origin assessment.
      - `id` string, uuid, required — The ID of the origin assessment.
      - `status` string, required — The status of an assessment. Possible values are: `DRAFT`, `SUBMITTED` or `OBSOLETE`.
    - `name` string, required — The name of the assessment.
    - `asset` Asset — The object for an asset in Collibra.
      - `id` string, uuid, required — The ID of the Collibra asset.
    - `status` string, required — The status of an assessment. Possible values are: `DRAFT`, `SUBMITTED` or `OBSOLETE`.
    - `template` Template, required — A base template object.
      - `id` string, uuid, required — The ID of the template.
      - `name` string, required — The name of the template.
      - `version` integer, required — The version of the template.
      - `status` string, required — The status of the template.
      - `assetType` AssetType — The object for an asset type in Collibra.
        - `id` string, uuid, required — The ID of the Collibra asset type.
      - `notification` boolean — Flag to indicate if notifications are on or off for the template.
      - `retakePermission` string — The retake permission is set on a template and dictates who can retake assessments of that template. Possible values are: * `All` : anyone with view access to the assessment can retake it. * `Owner` : only the owner of the assessment can retake it. * `OwnerAndAssignees` : only the owner and assignees of the assessment can retake it.
    - `owner` User, required — The object for a user in Collibra.
      - `id` string, uuid, required — The ID of the Collibra user.
    - `assignees` UserOrGroupAssignee[], required
      - union — An object that represents a user or group as assignee.
        - UserAssignee — The object for a user in Collibra.
          - `type` string, required — Possible values are: `USER` or `GROUP`.
          - `id` string, uuid, required — The ID of the Collibra user.
        - GroupAssignee — The base object for a user group in Collibra.
          - `type` string, required — Possible values are: `USER` or `GROUP`.
          - `id` string, uuid, required — The ID of the group.
          - `createdBy` string, uuid, required — Id of the Collibra user who created this group
          - `createdOn` integer, required — Timestamp when this group is created
          - `lastModifiedBy` string, uuid, required — Id of the Collibra user who last updated this group
          - `lastModifiedOn` integer, required — Timestamp when this group has last been updated
          - `name` string, required — The name of the group.
          - `mappings` GroupMapping[], required
            - `provider` string, required — Value must be "Snowflake", "GoogleBigQuery, or "AWSLakeFormation"
            - `identity` string, required — An existing Snowflake, GoogleBigQuery or AWSLakeFormation role.
    - `isVisibleToEveryone` boolean — Determines whether the assessment is visible to everyone. If set to 'false', only the Owner and Assignees will be able to access the assessment.
    - `content` QuestionAndAnswer[], required — The set of questions and answers of the assessment.
      - `id` string, required — The identifier of the question.
      - `name` string — The name of the question.
      - `description` string — The description of the question.
      - `answer` union — The object for an answer.
        - object — An answer object containing a text.
          - `type` string, required — The type of the answer to the question. Possible values are: `TEXT`, `HTML`, `DATE`, `BOOLEAN`, `ITEMS`, `NUMBER`, `EXPRESSION` or `ASSETS`.
          - `value` string, required
        - object — An answer object containing an html.
          - `type` string, required — The type of the answer to the question. Possible values are: `TEXT`, `HTML`, `DATE`, `BOOLEAN`, `ITEMS`, `NUMBER`, `EXPRESSION` or `ASSETS`.
          - `value` string, required
        - object — An answer object containing a date in ISO 8601 format, for example, 2017-07-21.
          - `type` string, required — The type of the answer to the question. Possible values are: `TEXT`, `HTML`, `DATE`, `BOOLEAN`, `ITEMS`, `NUMBER`, `EXPRESSION` or `ASSETS`.
          - `value` string, date, required
        - object — An answer object containing a boolean value.
          - `type` string, required — The type of the answer to the question. Possible values are: `TEXT`, `HTML`, `DATE`, `BOOLEAN`, `ITEMS`, `NUMBER`, `EXPRESSION` or `ASSETS`.
          - `value` boolean, required
        - object — An answer object containing items.
          - `type` string, required — The type of the answer to the question. Possible values are: `TEXT`, `HTML`, `DATE`, `BOOLEAN`, `ITEMS`, `NUMBER`, `EXPRESSION` or `ASSETS`.
          - `value` Item[], required
            - `id` string, required — The ID of the selected item.
            - `value` string — The value of the selected item.
        - object — An answer object containing a number value.
          - `type` string, required — The type of the answer to the question. Possible values are: `TEXT`, `HTML`, `DATE`, `BOOLEAN`, `ITEMS`, `NUMBER`, `EXPRESSION` or `ASSETS`.
          - `value` number, required
        - object — An answer object containing the result of an expression.
          - `type` string, required — The type of the answer to the question. Possible values are: `TEXT`, `HTML`, `DATE`, `BOOLEAN`, `ITEMS`, `NUMBER`, `EXPRESSION` or `ASSETS`.
          - `value` string, required
        - object — An answer object containing assets.
          - `type` string, required — The type of the answer to the question. Possible values are: `TEXT`, `HTML`, `DATE`, `BOOLEAN`, `ITEMS`, `NUMBER`, `EXPRESSION` or `ASSETS`.
          - `value` Asset[], required
            - `id` string, uuid, required — The ID of the Collibra asset.
        - object — An answer object containing users and or groups.
          - `type` string, required — The type of the answer to the question. Possible values are: `TEXT`, `HTML`, `DATE`, `BOOLEAN`, `ITEMS`, `NUMBER`, `EXPRESSION` or `ASSETS`.
          - `value` UserOrGroupAnswer[], required
            - union — An object that represents a user or group.
              - …
        - object — An answer object containing attachments.
          - `type` string, required — The type of the answer to the question. Possible values are: `TEXT`, `HTML`, `DATE`, `BOOLEAN`, `ITEMS`, `NUMBER`, `EXPRESSION` or `ASSETS`.
          - `value` AssessmentAttachment[], required
            - `id` string, uuid, required — ID of the attachment
            - `fileName` string — Original file name of the attachment
            - `createdBy` string, uuid — ID of the user who created the attachment
            - `createdOn` string, date-time — Date and time attachment was created
      - `comments` string — The comments added to the question.
    - `createdOn` string, date-time, required — The date and time of the assessment creation.
    - `createdBy` User, required — The object for a user in Collibra.
      - `id` string, uuid, required — The ID of the Collibra user.
    - `lastModifiedOn` string, date-time, required — The date and time of the assessment last update.
    - `lastModifiedBy` User, required — The object for a user in Collibra.
      - `id` string, uuid, required — The ID of the Collibra user.
    - `submittedOn` string, date-time — The date and time of the assessment submission.
    - `submittedBy` User — The object for a user in Collibra.
      - `id` string, uuid, required — The ID of the Collibra user.
    - `assessmentReview` Asset — The object for an asset in Collibra.
      - `id` string, uuid, required — The ID of the Collibra asset.

## Other responses

- `400` — The request is not valid.
- `401` — The client is not authenticated.
- `403` — The user lacks permissions.
- `500` — There was an error processing the request.

---

[API](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api.md) · [All operations](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collibra/collibra-data-governance-center-core-api/revisions/6d091bc86a33/schema)