> ## 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 specific test part with all its sections

> Retrieve a test part by identifier including all its sections and their assessment item references. Test parts define navigation and submission behaviors for groups of sections. Supports both JSON and XML response formats.



## OpenAPI

````yaml /openapi/beyond-ai/qti-api.yaml get /assessment-tests/{assessmentTestIdentifier}/test-parts/{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 QTI compliant XSD files. XSD version
      supported is 3.0.0 (3p0)
  - 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/{identifier}:
    get:
      tags:
        - Test Part Management
      summary: Get a specific test part with all its sections
      description: >-
        Retrieve a test part by identifier including all its sections and their
        assessment item references. Test parts define navigation and submission
        behaviors for groups of sections. Supports both JSON and XML response
        formats.
      operationId: getTestPart
      parameters:
        - name: assessmentTestIdentifier
          description: The unique identifier of the parent assessment test
          in: path
          required: true
          schema:
            type: string
        - name: identifier
          description: The unique identifier of the test part to retrieve
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved test part
          content:
            application/json:
              schema:
                type: object
                properties:
                  identifier:
                    type: string
                    description: Unique identifier for the entity on the service provider.
                  navigationMode:
                    type: string
                    enum:
                      - linear
                      - nonlinear
                    description: >-
                      Controls how learners navigate through the test part.
                      'linear' requires items to be responded to in sequence
                      without jumping around, while 'nonlinear' allows
                      candidates to respond to items in any order they choose.
                  submissionMode:
                    type: string
                    enum:
                      - individual
                      - simultaneous
                    description: >-
                      Determines how learner responses are submitted for
                      response processing. 'individual' allows responses to be
                      submitted as each item is completed, while 'simultaneous'
                      means responses for all items are sent when the whole part
                      is completed.
                  qti-assessment-section:
                    type: array
                    items:
                      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
                            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.
                  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
                  - navigationMode
                  - submissionMode
                  - qti-assessment-section
                description: >-
                  Complete test part data returned from the service provider.
                  Contains all sections and their configuration.
        '404':
          description: Assessment test or test part not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error type identifier
                  message:
                    type: string
                    description: Human-readable error message
                  eventId:
                    type: string
                    description: Sentry event ID for error tracking
                  details:
                    type: string
                    description: Stack trace or additional error details
                required:
                  - error
                  - message
                  - details
                description: Internal server error response
components:
  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

````