v1

latestOpenAPI 3.1.0Apache 2.02026-07-245981,1853.0 MB

Assessments

Get Assessment

Use this API to retrieve details of a specific assessment. The response will include details such as basic assessment information, respondents, approvers, assessment questions and responses, and assessment risks.

🗒 Things to Know

The API response body will include all assessment responses received for that assessment after the assessment was launched. If a response record references an object (such as vendors, engagements, or assets) that was subsequently deleted from the OneTrust Platform after the assessment was launched, that record would still be included within the response body but would no longer exist in the OneTrust Platform.

get/api/assessment/v2/assessments/{assessmentId}/export

Path parameters

assessmentIdstring uuid required

UUID of the assessment to export

Query parameters

excludeSkippedQuestionsboolean

Flag to exclude skipped questions from the export

Response

assessmentIdstring uuid

Unique identifier of the assessment

assessmentNumberinteger

Sequential number assigned to the assessment

namestring

Name of the assessment

descriptionstring

Description of the assessment

welcomeTextstring

Welcome text displayed at the beginning of the assessment

status'NOT_STARTED' | 'IN_PROGRESS' | 'UNDER_REVIEW' | 'COMPLETED'

Current status of the assessment

createdDTstring date-time

Date and time when the assessment was created (in UTC)

deadlinestring date-time

Deadline for completing the assessment

submittedOnstring date-time

Date when the assessment was submitted for review

completedOnstring date-time

Date when the assessment was completed

resultstring

Result of the assessment (deprecated, use resultName instead)

resultIdstring uuid

Unique identifier of the assessment result

resultNamestring

Name of the assessment result

lowRiskinteger

Count of low risk findings in the assessment

mediumRiskinteger

Count of medium risk findings in the assessment

highRiskinteger

Count of high risk findings in the assessment

veryHighRiskinteger

Count of very high risk findings in the assessment

totalRiskCountinteger

Total count of all risk findings in the assessment

riskLevelstring

Overall risk level of the assessment

residualRiskScorenumber

Residual risk score after mitigations

openRiskCountinteger

Count of open risks in the assessment

inherentRiskScorenumber

Inherent risk score before mitigations

targetRiskScorenumber

Target risk score to achieve

lastUpdatedstring date-time

Date and time when the assessment was last updated (in UTC)

primaryRecordTypestring

Type of the primary record associated with the assessment

tagsstring[]

List of tags associated with the assessment