Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/geeky-hamster/Quizmaster/llms.txt

Use this file to discover all available pages before exploring further.

The admin scores page gives you a complete record of every quiz attempt made on the platform, including who took each quiz, when they took it, how many questions they answered correctly, and how long they spent. Regular users can only see their own scores; as an admin, you have visibility across all users and all quizzes from a single page.

Accessing the scores page

Navigate to /admin/scores to open the scores dashboard. The page loads all score records with associated user and quiz information.

What each score record shows

Each row in the scores table corresponds to one quiz attempt and includes the following fields:
FieldDescription
user.fullNameFull name of the user who took the quiz
user.usernameThe user’s login email
quiz.nameName of the quiz that was attempted
time_stamp_of_attemptDate and time the quiz was submitted
total_questionsTotal number of questions in the quiz at the time of submission
total_scoredNumber of questions the user answered correctly
time_takenTime the user spent on the quiz, if recorded
A user’s percentage score can be calculated as (total_scored / total_questions) × 100.

Filtering scores by quiz

To view scores for a specific quiz, use the API endpoint GET /api/scores/quiz/:quizId, where :quizId is the numeric ID of the quiz. This returns only the score records for that quiz, each with the same user and score fields described above.
Compare total_scored averages across quizzes to identify which ones users find most difficult. A quiz with a consistently low average score may need clearer question wording, a revised time limit, or updated content.

Score data and deleted content

Score records reference both the quiz and the user. If a user account is deleted, their scores are also removed. If a quiz is deleted, all scores for that quiz are removed as well. Export or record important score data before deleting quizzes or user accounts.

Build docs developers (and LLMs) love