> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timeback.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a section with all its assessment item references

> Retrieve a specific section including all its assessment item references, presentation settings, and configuration. Sections define how groups of assessment items are presented to test takers.



## OpenAPI

````yaml /openapi/beyond-ai/qti-api.yaml get /assessment-tests/{assessmentTestIdentifier}/test-parts/{testPartIdentifier}/sections/{identifier}
openapi: 3.1.0
info:
  title: QTI API
  version: 1.0.0
  description: >-
    A robust assessment engine implementing the QTI 3.0 specification, designed
    for creating, managing, and delivering educational assessments.
servers:
  - url: https://qti.alpha-1edtech.ai/api
    description: Main Server
security:
  - OAuth2: []
  - MCP: []
tags:
  - name: Validation
    description: Validate XML strings against the QTI 3.0.1 schema
  - name: Feedback
    description: Feedback for questions and lessons
  - name: Assessment Test Management
    description: >-
      Enables the management of Assessment Tests. Assessment Tests are the main
      entities that contain Assessment Test Parts, Sections, and Assessment
      Items.
  - name: Test Part Management
    description: >-
      Enables the management of Test Parts. Assessment Test Parts are used to
      group sections inside of an Assessment Test.
  - name: Section Management
    description: >-
      Enables the management of Sections. Assessment Sections are used to group
      Assessment Items.
  - name: Assessment Item Management
    description: >-
      Enables the management of Assessment ITems. Assessment Items are made up
      of QTI Interactions (e.g. questions, multiple choice, etc.).
  - name: Stimulus Management
    description: >-
      Enables the management of Stimuli. Stimuli are shared content pieces
      (text, images, audio, video) that provide context for assessment items and
      can be referenced by multiple questions.
paths:
  /assessment-tests/{assessmentTestIdentifier}/test-parts/{testPartIdentifier}/sections/{identifier}:
    get:
      tags:
        - Section Management
      summary: Get a section with all its assessment item references
      description: >-
        Retrieve a specific section including all its assessment item
        references, presentation settings, and configuration. Sections define
        how groups of assessment items are presented to test takers.
      operationId: getSection
      parameters:
        - name: assessmentTestIdentifier
          description: Root assessment test identifier
          in: path
          required: true
          schema:
            type: string
        - name: testPartIdentifier
          description: Parent test part identifier
          in: path
          required: true
          schema:
            type: string
        - name: identifier
          description: Section identifier
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved section
          content:
            application/json:
              schema:
                type: object
                properties:
                  identifier:
                    type: string
                    description: Unique identifier for the entity on the service provider.
                  title:
                    type: string
                    description: >-
                      Human-readable title of the entity on the service
                      provider.
                  visible:
                    type: boolean
                    default: true
                    description: >-
                      Determines whether the assessment section is visible to
                      candidates during test delivery. Sections are visible by
                      default unless explicitly hidden for specific assessment
                      conditions.
                  required:
                    type: boolean
                    default: true
                    description: >-
                      If a child element is required it must appear (at least
                      once) in the selection.
                  fixed:
                    type: boolean
                    default: false
                    description: >-
                      If a child element is fixed it must never be shuffled.
                      When used in combination with a selection rule fixed
                      elements do not have their position fixed until after
                      selection has taken place.
                  sequence:
                    type: integer
                    exclusiveMinimum: 0
                    description: >-
                      Defines the sequential order of this item within its
                      parent section. Must be a positive integer that determines
                      presentation order to candidates.
                  qti-assessment-item-ref:
                    type: array
                    items:
                      type: object
                      properties:
                        identifier:
                          type: string
                          description: >-
                            Unique identifier for the entity on the service
                            provider.
                        href:
                          type: string
                          description: >-
                            URI reference to the assessment item resource
                            location on the service provider
                        qti-pre-condition:
                          type: array
                          items:
                            type: object
                            additionalProperties: {}
                          description: >-
                            Array of QTI 3.0 pre-conditions. Each pre-condition
                            contains a logical expression that is evaluated
                            before the element is presented. If any
                            pre-condition evaluates to false, the element is
                            skipped.
                        qti-branch-rule:
                          type: array
                          items:
                            type: object
                            additionalProperties: {}
                          description: >-
                            Array of QTI 3.0 branch rules. Each branch rule
                            contains a logical expression that, when evaluated
                            to true after the element is presented, causes the
                            test to jump to the target identified by the rule.
                      required:
                        - identifier
                      description: >-
                        Assessment item reference schema for linking assessment
                        items to sections
                    description: >-
                      Collection of assessment items that are referenced within
                      this section.
                  qti-pre-condition:
                    type: array
                    items:
                      type: object
                      additionalProperties: {}
                    description: >-
                      Array of QTI 3.0 pre-conditions. Each pre-condition
                      contains a logical expression that is evaluated before the
                      element is presented. If any pre-condition evaluates to
                      false, the element is skipped.
                  qti-branch-rule:
                    type: array
                    items:
                      type: object
                      additionalProperties: {}
                    description: >-
                      Array of QTI 3.0 branch rules. Each branch rule contains a
                      logical expression that, when evaluated to true after the
                      element is presented, causes the test to jump to the
                      target identified by the rule.
                required:
                  - identifier
                  - title
                  - visible
                description: >-
                  Complete assessment section data with all referenced items.
                  Represents a section containing learning content within a test
                  part.
        '400':
          description: Malformed JSON, or a body or parameter the schema rejects
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '401':
          description: No bearer token, or an invalid one
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '403':
          description: >-
            The token lacks the required scope, or the caller does not own the
            resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '404':
          description: Assessment test, test part, or section not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '413':
          description: The request body is larger than 50 MB
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '503':
          description: Database unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
components:
  schemas:
    ErrorBody:
      type: object
      properties:
        error:
          type: string
          description: The problem in one sentence (same as detail)
        code:
          type: string
          description: >-
            The reason phrase with the spaces removed, for every error:
            BadRequest, Unauthorized, Forbidden, NotFound, Conflict, Gone,
            ContentTooLarge, UnsupportedMediaType, UnprocessableContent,
            InternalServerError, ServiceUnavailable
        details:
          type: string
          description: The individual errors joined into one line, when there are any
        title:
          type: string
          description: The HTTP reason phrase (RFC 9457)
        status:
          type: integer
          description: The HTTP status code (RFC 9457)
        detail:
          type: string
          description: >-
            The problem in one sentence (RFC 9457); on a 500 it is the phrase
            and nothing more
        errors:
          type: array
          items:
            type: object
            properties:
              detail:
                type: string
              pointer:
                type: string
                description: JSON Pointer to the offending part of the request
            required:
              - detail
          description: Individual problems, for validation failures
        traceId:
          type: string
          pattern: ^[0-9a-f]{32}$
          description: W3C trace id of the request; absent when no trace was active
      required:
        - error
        - code
        - title
        - status
        - detail
      description: Error response
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        clientCredentials:
          scopes:
            https://purl.imsglobal.org/spec/qti/v3/scope/readonly: Read access to QTI
            https://purl.imsglobal.org/spec/qti/v3/scope/createput: Create and update access to QTI
            https://purl.imsglobal.org/spec/qti/v3/scope/delete: Delete access to QTI
          tokenUrl: >-
            https://prod-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/token
    MCP:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: >-
            https://prod-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/authorize
          tokenUrl: >-
            https://prod-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/token
          scopes:
            https://purl.imsglobal.org/spec/qti/v3/scope/readonly: Read access to QTI

````