---
title: "Get Quiz History"
method: GET
path: "/knowledge-quiz/courses/{course_id}/history"
tags: ["knowledge-quiz"]
---

# Get Quiz History

`GET /knowledge-quiz/courses/{course_id}/history`

Get the student's quiz attempt history for a course.

## Path parameters

- `course_id` string, required

## Query parameters

- `assignment_id` string, required

## Response `200`

Successful Response

- QuizHistoryResponse — Response for quiz attempt history.
  - `attempts` AttemptResponse[], required
    - `id` string, required
    - `quiz_id` string, required
    - `student_id` string, required
    - `course_id` string, required
    - `assignment_id` string, required
    - `status` string, required
    - `score_out_of_20` number, required
    - `correct_count` integer, required
    - `total_questions` integer, required
    - `attempt_number` integer, required
    - `started_at` string, date-time, required
    - `completed_at` string, date-time, nullable
    - `answers` QuizAnswerRecord[]
      - `question_id` string, required
      - `answer_type` 'choice' | 'open'
      - `selected_answer_index` integer, nullable
      - `is_correct` boolean
      - `photo_urls` string[]
      - `grading_status` 'processing' | 'graded' | 'error' | 'rejected', nullable
      - `grading_error` string, nullable
      - `rubric_evaluation` RubricEvaluation — One evaluation pass over a submission against a specific rubric. Multiple may exist per submission attempt (initial AI + teacher overrides); the latest one is canonical.
        - `rubric_id` string, required
        - `author` union, required
          - AIAuthor
            - `type` 'ai'
            - `prompt_id` string, required
            - `model` string, nullable
          - HumanAuthor
            - `type` 'human'
            - `user_id` string, required
        - `feedback` string, required
        - `questions` RubricQuestionEvaluation[], required
          - `skill_outcomes` SkillOutcome[], required
            - `savoir_faire_id` string, required
            - `outcome` 'correct' | 'partial' | 'wrong' | 'unanswered', required
            - `note` string, required
            - `evidence` EvidenceSpan[], required
              - …
          - `criterion_outcomes` CriterionOutcome[], required
            - `criterion_index` integer, required
            - `outcome` 'correct' | 'partial' | 'wrong' | 'unanswered', required
            - `note` string, required
            - `evidence` EvidenceSpan[], required
              - …
          - `errors` FlaggedError[], required
            - `description` string, required
            - `evidence` EvidenceSpan[], required
              - …
            - `categories` ErrorCategory[], nullable
        - `question_zones` QuestionZone[]
          - `question_indexes` integer[], required
          - `boxes` PhotoBBox[], required
            - `photo_index` integer, required
            - `x` number, required
            - `y` number, required
            - `width` number, required
            - `height` number, required
        - `computed_grade` number, required
        - `max_grade` number, required
        - `evaluated_at` string, date-time, required
      - `points_earned` number
      - `points_max` number
  - `best_score` number, required
  - `attempts_count` integer, required
  - `max_attempts` integer, nullable
  - `can_retry` boolean, required
  - `quiz_start_date` string, date-time, nullable
  - `quiz_end_date` string, date-time, nullable
  - `is_enabled` boolean
  - `is_open` boolean

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-09** `e75413b9576a` — 4 info
  - added the optional property `is_enabled` to the response with the `200` status
  - added the optional property `is_open` to the response with the `200` status
  - added the optional property `quiz_end_date` to the response with the `200` status
  - added the optional property `quiz_start_date` to the response with the `200` status
- **2026-09-07** `0ccba2913cca` — 1 info
  - added the optional property `attempts/items/answers/items/rubric_evaluation/anyOf[subschema #1: RubricEvaluation]/author/oneOf[subschema #1: AIAuthor]/model` to the response with the `200` status
- **2026-09-03** `ef67479ed898` — 1 info
  - added the optional property `attempts/items/answers/items/rubric_evaluation/anyOf[subschema #1: RubricEvaluation]/questions/items/errors/items/categories` to the response with the `200` status

[Change history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/knowledge-quiz/courses/:course_id/history/get.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/2a0c1636fd3b?raw)
