---
title: "Get Sheet Run"
method: GET
path: "/knowledge-quiz/attempts/{attempt_id}/sheet"
tags: ["knowledge-check-sheet"]
---

# Get Sheet Run

`GET /knowledge-quiz/attempts/{attempt_id}/sheet`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/knowledge-quiz/attempts/{attempt_id}/sheet`
- Auth: OAuth 2 (password, token URL `api/login`)

Where the student is: the current question with its remaining time
(the only question served), the photo step, the grading or the results.
Polled while the sheet is graded.

## Path parameters

- `attempt_id` string, required

## Response `200`

Successful Response

- SheetRunResponse
  - `attempt_id` string, required
  - `status` 'answering' | 'photo' | 'grading' | 'graded' | 'error', required
  - `total_questions` integer, required
  - `position` integer, required
  - `question` SheetQuestionResponse: The question on screen. Nothing of its answer.
    - `number` integer, required
    - `question_id` string, required
    - `question_type` string, required
    - `question` string, required
    - `options` string[]
    - `seconds_total` integer, required
    - `seconds_remaining` integer, required
  - `page_urls` string[]
  - `grading_error` string, nullable
  - `results` SheetResultResponse[]
    - `number` integer, required
    - `question_id` string, required
    - `question_type` string, required
    - `question` string, required
    - `verdict` 'correct' | 'partial' | 'wrong', required
    - `is_correct` boolean, required
    - `points_earned` number, required
    - `points_max` number, required
    - `transcription` string
    - `correction` string, nullable
  - `score_out_of_20` number, nullable
  - `correct_count` integer, nullable
  - `points_earned` number, nullable
  - `points_max` number, nullable

## Other responses

- `404`: Resource not found
- `409`: Business rule violated
- `422`: Validation Error

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-10-15** `7925dd21e4d0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/knowledge-quiz/attempts/:attempt_id/sheet/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/379e4a57dee8?raw)