Quiz results

Quiz results are returned after the quiz is completed. If no students list was provided, students will be named as seen in Classwise (e.g., "Classpad 1", "Classpad 2", etc.).

Quiz finished with students

JSON example:

{
  "message_type": "quiz_result",
  "data": {
    "mode": "Default",
    "title": "Sample Quiz",
    "scoreboard": [
      {
        "position": 1,
        "fullName": "Jason Martinez",
        "correctAnswers": 5,
        "percentage": 100
      },
      {
        "position": 2,
        "fullName": "Emily Johnson",
        "correctAnswers": 5,
        "percentage": 100
      },
      {
        "position": 3,
        "fullName": "Michael Smith",
        "correctAnswers": 3,
        "percentage": 60
      },
      {
        "position": 4,
        "fullName": "Sarah Brown",
        "correctAnswers": 2,
        "percentage": 40
      }
    ],
    "answers": [
      {
        "question": "What is the capital of France?",
        "studentAnswers": [
          {
            "fullName": "Jason Martinez",
            "answer": "Paris",
            "isCorrect": true
          },
          {
            "fullName": "Emily Johnson",
            "answer": "Paris",
            "isCorrect": true
          },
          {
            "fullName": "Michael Smith",
            "answer": "Paris",
            "isCorrect": true
          },
          {
            "fullName": "Sarah Brown",
            "answer": "Paris",
            "isCorrect": true
          }
        ]
      },
      {
        "question": "Which of these is the Mona Lisa?",
        "studentAnswers": [
          {
            "fullName": "Jason Martinez",
            "answer": "Option 2",
            "isCorrect": true
          },
          {
            "fullName": "Emily Johnson",
            "answer": "Option 2",
            "isCorrect": true
          },
          {
            "fullName": "Michael Smith",
            "answer": "Option 4",
            "isCorrect": false
          },
          {
            "fullName": "Sarah Brown",
            "answer": "Option 3",
            "isCorrect": false
          }
        ]
      },
      {
        "question": "The Earth is flat.",
        "studentAnswers": [
          {
            "fullName": "Jason Martinez",
            "answer": "False",
            "isCorrect": true
          },
          {
            "fullName": "Emily Johnson",
            "answer": "False",
            "isCorrect": true
          },
          {
            "fullName": "Michael Smith",
            "answer": "False",
            "isCorrect": true
          },
          {
            "fullName": "Sarah Brown",
            "answer": "True",
            "isCorrect": false
          }
        ]
      },
      {
        "question": "What is this famous landmark? (Watch the video)",
        "studentAnswers": [
          {
            "fullName": "Jason Martinez",
            "answer": "Eiffel Tower",
            "isCorrect": true
          },
          {
            "fullName": "Emily Johnson",
            "answer": "Eiffel Tower",
            "isCorrect": true
          },
          {
            "fullName": "Michael Smith",
            "answer": "Statue of Liberty",
            "isCorrect": false
          },
          {
            "fullName": "Sarah Brown",
            "answer": "Statue of Liberty",
            "isCorrect": false
          }
        ]
      },
      {
        "question": "What sound is this?",
        "studentAnswers": [
          {
            "fullName": "Jason Martinez",
            "answer": "Cat Meowing",
            "isCorrect": true
          },
          {
            "fullName": "Emily Johnson",
            "answer": "Cat Meowing",
            "isCorrect": true
          },
          {
            "fullName": "Michael Smith",
            "answer": "Cat Meowing",
            "isCorrect": true
          },
          {
            "fullName": "Sarah Brown",
            "answer": "Cat Meowing",
            "isCorrect": true
          }
        ]
      }
    ]
  }
}

Fields definitions:

Root Object

Field	Type	Required	Constraints	Description
message_type	string	Yes	quiz_result	Message type indicating it contains quiz results
data	object	Yes	—	Quiz result data

Data Object (PartnerQuizQuestionData)

Field	Type	Required	Constraints	Description
mode	string	Yes	One of: Default, Test, Custom	Mode of the quiz
title	string	Yes	—	Title of the quiz
totalQuestions	number	Yes	—-	Total number of questions displayed in quiz
answers	array	Yes	—	List of answered questions
scoreboard	array	Yes	—	Final scoreboard

Question Object (answers[])

Field	Type	Required	Constraints	Description
question	string	Yes	—	The quiz question text
studentAnswers	array	Yes	—	List of student answers to this question

Student Answer Object (studentAnswers[])

Field	Type	Required	Constraints	Description
fullName	string	Yes	—	Full name of the student
answer	string	Yes	—	The student’s answer
isCorrect	boolean	Yes	—	Whether the answer was correct

Scoreboard Entry Object (scoreboard[])

Field	Type	Required	Constraints	Description
position	number	Yes	—	Final rank in the scoreboard
fullName	string	Yes	—	Student’s full name
percentage	number	Yes	—	Percentage of correct answers
correctAnswers	number	Yes	—	Number of correct answers