---
title: "Retrieve an assessment by ID"
method: GET
path: "/assessments/{id}"
tags: ["Assessments"]
---

# Retrieve an assessment by ID

`GET /assessments/{id}`

Returns information about the assessment with the specified ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

Example of a response for retrieving an assessment.

- Assessment — An assessment object.
  - `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.
            - UserAnswer — The object for a user in Collibra.
              - …
            - GroupAnswer — Type identifying 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.
- `404` — Resource not found.
- `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)
