---
title: "Get Assessment Question Section"
method: GET
path: "/api/assessment/v2/assessments/{assessmentId}/sections/navigate"
tags: ["Assessments"]
---

# Get Assessment Question Section

`GET /api/assessment/v2/assessments/{assessmentId}/sections/navigate`

## Request

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

Use this API to retrieve a section of assessment questions. The response includes the questions within the requested section, available response options, and any previously submitted responses. Questions hidden by navigation rules are not returned.

> 🗒 Things to Know
>
> - By default, only required unanswered questions are returned.
> - To retrieve all questions in the section, specify `filter=ALL_QUESTIONS` as a query parameter.
> - To retrieve the assessment's welcome or introduction content instead of assessment questions, specify `direction=WELCOME` as a query parameter. If no welcome content is configured, specify `direction=FIRST`.
> - Each question includes available response options and any previously submitted responses. Response option identifiers can be used when submitting responses through the [Submit Responses API](https://developer.onetrust.com/onetrust/reference/submitresponsesusingpost).

## Path parameters

- `assessmentId` string, uuid, required

## Query parameters

- `direction` 'WELCOME' | 'FIRST' | 'CURRENT' | 'NEXT' | 'PREVIOUS', required
- `sectionId` string, uuid
- `filter` 'ALL_QUESTIONS' | 'UNANSWERED_QUESTIONS' | 'REQUIRED_QUESTIONS' | 'REQUIRED_UNANSWERED_QUESTIONS' | 'EFFECTIVENESS_SCALE_QUESTIONS'

## Response `200`

OK

- PrivacyAutomationAssessmentAutomationAssessmentSectionMcpResponse
  - `sectionId` string, uuid: UUID to use as `sectionId` in subsequent navigation/submission calls.
  - `sectionName` string: Display name of the section.
  - `sectionDescription` string: Optional longer description of the section.
  - `sectionSequence` integer: 1-based position of this section within the assessment.
  - `isFirstSection` boolean: Whether this is the first section in the assessment.
  - `isLastSection` boolean: Whether this is the last section in the assessment.
  - `totalQuestions` integer: Total number of questions across the whole assessment (not just this section).
  - `respondedQuestions` integer: Number of questions answered so far across the whole assessment (not just this section).
  - `questions` PrivacyAutomationAssessmentAutomationAssessmentQuestionMcpResponse[]
    - `questionId` string, uuid: UUID to use as `questionId` when submitting a response.
    - `content` string: The question text shown to the respondent.
    - `friendlyName` string: Short display name for the question, if different from `content`.
    - `description` string: Optional longer description of the question.
    - `questionType` 'TEXTBOX' | 'MULTICHOICE' | 'YESNO' | 'DATE' | 'STATEMENT' | 'INVENTORY' | 'INCIDENT' | 'ATTRIBUTE' | 'PERSONAL_DATA' | 'YES_NO_PARTIALLY' | 'CONTROL' | 'CONTRACT' | 'ENGAGEMENT' | 'ASSESS_CONTROL' | 'ASSESS_RISK' | 'ASSESS_ISSUE' | 'CUSTOM_ENTITY' | 'RELATIONSHIP' | 'DISCLOSURE': The question's input widget/format, e.g. MULTICHOICE, YESNO, TEXTBOX, DATE, ATTRIBUTE, CONTROL, INVENTORY, PERSONAL_DATA. Determines whether the answer is carried in `responses` or `subQuestions` (see those fields) and which fields within them are relevant.
    - `required` boolean: Whether a response is mandatory before the assessment can be submitted.
    - `hint` string: Optional hint text shown alongside the question.
    - `attachmentRequired` boolean: Whether at least one attachment must be added to this question (via the attachments management tool) before the assessment can be submitted.
    - `questionLaws` PrivacyAutomationAssessmentAutomationLawInformation[]
      - `name` string
    - `options` PrivacyAutomationAssessmentAutomationAssessmentQuestionOptionMcpResponse[]
      - `id` string, uuid: UUID to use as `responseId` when selecting this option.
      - `option` string: The option text shown to the respondent.
      - `sequence` integer: Display order of this option among its siblings.
      - `optionType` 'NOT_SURE' | 'NOT_APPLICABLE' | 'OTHERS' | 'DEFAULT': The option's type.
      - `hint` string: Optional hint text shown alongside this option.
      - `preSelectedOption` boolean: Whether this option is pre-selected by default.
    - `isParentQuestionMultiSelect` boolean: For questions whose answer is carried in `subQuestions` (ATTRIBUTE/CONTROL/CONTRACT/ENGAGEMENT types), whether multiple sub-question instances can be added.
    - `justification` string: Free-text justification already provided for this question, if any.
    - `maturityScale` integer: Maturity scale value already selected, only for maturity-scale questions.
    - `effectivenessScale` integer: Effectiveness scale value already selected, only for effectiveness-scale questions.
    - `responses` PrivacyAutomationAssessmentAutomationResponseInformationUiDto
      - `invalidQuestionIds` string[]
      - `allIds` string[]
      - `byId` object
      - `invalidResponsesMap` object
    - `subQuestions` PrivacyAutomationAssessmentAutomationSubQuestionUiDto
      - `allIds` string[]
      - `byId` object
  - `welcomeSection` PrivacyAutomationAssessmentAutomationWelcomeSection
    - `gettingStartedBannerEnabled` boolean: Indicates if the getting-started banner is enabled
    - `welcomeTitle` string: Title of the welcome section
    - `welcomeText` string: Text of the welcome section
    - `welcomeTitleKey` string
    - `welcomeTextKey` string
    - `hideWelcomeSection` boolean: Indicates if the welcome section is hidden

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