---
title: "Get quiz"
method: GET
path: "/v2/quizzes/{id}"
tags: ["Quizzes"]
---

# Get quiz

`GET /v2/quizzes/{id}`

Retrieve a single quiz by ID.

**Required OAuth scope:** `quizzes:read`

## Path parameters

- `id` string, required

## Response `200`

OK

- QuizDetailResponse — Single-resource envelope for GET /v2/quizzes/{id}/ responses.
  - `data` QuizResource, required — JSON:API resource object for a quiz.
    - `type` 'quizzes' — Always "quizzes".
    - `id` string, required — Opaque quiz ID. Use in URL paths.
    - `attributes` QuizAttributes, required — Attributes of a quiz resource object. Fields mirror the ``quiz.models.Quiz`` columns exposed on the public API. ``organization`` and internal primary keys are deliberately not exposed — ``id`` (obfuscated) and ``external_id`` (UUID5) are the only identifiers a client sees.
      - `name` string, required — Quiz name.
      - `description_html` string — HTML description shown on the quiz start screen.
      - `passing_percentage_correct` integer, required — Percentage of questions a student must answer correctly to pass.
      - `max_attempts` integer, required — Maximum attempts allowed. 0 means unlimited.
      - `require_correct_response` boolean, required — If true, students must answer each question correctly before proceeding.
      - `randomize_questions` boolean, required — If true, questions are presented in a random order.
      - `limit_question_count` integer, required — Number of questions presented (selected at random). 0 means all questions.
      - `randomize_answers` boolean, required — If true, answer choices are presented in a random order.
      - `show_results_on_failure` boolean, required — If true, students who fail can review their submitted answers and per-question status.
      - `show_question_feedback` boolean, required — If true, students receive per-question feedback on auto-graded questions.
      - `time_limit_seconds` integer, nullable — Time limit in seconds, or null for unlimited time.
      - `skip_start_screen` boolean, nullable — If true, the start screen and description are hidden. May be null.
      - `alignment` 'left' | 'center' | 'right', required — Text alignment for the description and start screen.
      - `external_id` string, required — Stable UUID5 for cross-system correlation.
      - `created_at` string, date-time, required — Timestamp when the quiz was created.
      - `modified_at` string, date-time, required — Timestamp when the quiz was last modified.
    - `links` object, nullable — Self and related links.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/skilljar/apis/skilljar-api-v2.md) · [All operations](https://skmtc.net/skilljar/apis/skilljar-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skilljar/skilljar-api-v2/revisions/f8025de20169/schema)