GetNextQuestionResponse

  • question
    Type: object | null · NullableQuestion
    required
    • choices
      Type: array object[] · Choice[]
      required

      Available answer choices

    • fact
      required

      The fact displayed to the student (a held-out probe for transfer contracts)

      • answer
        Type: object · CardAnswer
        required

        The gradable answer for this card

      • factSetId
        Type: string
        required
      • id
        Type: string
        required
      • reviewResponse
        Type: object · ReviewResponse
        required

        Generated response expected during review

      • text
        Type: string
        required

        Prompt displayed to the student (e.g., "7 x 8 = ?")

      • cardType
        Type: string · CardTypeenum

        Retrieval card type

        values
        • MathBinary = MATH_BINARY
        • MathUnary = MATH_UNARY
        • MathMissingOperand = MATH_MISSING_OPERAND
        • MathRational = MATH_RATIONAL
      • factorA
        Type: integer

        First or sole operand (math-binary and math-unary cards)

      • factorB
        Type: integer

        Second operand (math-binary cards only)

      • fractionOperation
        Type: object · FractionOperation

        Structured fraction operation for rational cards

      • operator
        Type: string · Operatorenum

        Mathematical operator

        values
        • x = MULTIPLY
        • + = ADD
        • - = SUBTRACT
        • ÷ = DIVIDE
      • rational
        Type: object · FractionAnswer

        Reduced source rational for rational conversion cards

      • relationships
        Type: array object[]

        Related facts (e.g., fact family members)

      • result
        Type: integer

        Arithmetic result of factorA operator factorB (math-binary cards only)

      • suppliedDistractors
        Type: array object[] · CardAnswer[]

        Content-supplied wrong answers; when absent, distractors are derived per card type

        The gradable answer for this card

      • unaryOperation
        Type: string · UnaryOperationenum

        Operation performed by a math-unary card

        values
        • square = SQUARE
        • square-root = SQUARE_ROOT
        • cube = CUBE
        • cube-root = CUBE_ROOT
    • id
      Type: string
      required
    • responseMode
      Type: string · QuestionResponseModeenum
      required

      Input format required to answer a question

      values
      • choice = CHOICE
      • integer = INTEGER
      • decimal = DECIMAL
      • percent = PERCENT
      • fraction = FRACTION
    • sourceFactId
      Type: string
      required

      Stable fact whose progress this question advances

    • stageType
      Type: string · LearningStageTypeenum
      required

      Learning stage type

      values
      • grounding
      • assessment
      • practice
      • review
      • repetition
      • mastered
    • premature
      Type: boolean

      Whether the question was raised prematurely

    • roundingDigits
      Type: integer
      min:  
      0

      Required precision for approximate responses

    • timeToAnswer
      Type: number

      Time limit to answer in seconds

  • sessionId
    Type: string
    required

    The session ID for the current session

  • algorithmId
    Type: string · AlgorithmIdenum
    values
    • practice
    • competition
    • review
  • availabilityStatus
    • Type: string · SkillAvailabilityenum

      Current playability of the skill, always present (Available unless the skill cannot be played right now)

      values
      • Available
      • AllFactsOnCooldown
  • sessionStatus
    Type: string · SessionStatusenum

    Live-session lifecycle outcome returned during an active learning session

    values
    • InProgress
    • SessionCompleted
    • SkillUnavailable
    • ExceededStrugglingThreshold
    • SessionCompletionRecommended
  • startReview
    Type: object · StartReview
    • factSetId
      Type: string
      required

      The fact set ID to start a review session for