---
title: "Get Course Deck Bookmarks"
method: GET
path: "/teacher/courses/{course_id}/deck-bookmarks"
tags: ["Teacher Course Bookmarks"]
---

# Get Course Deck Bookmarks

`GET /teacher/courses/{course_id}/deck-bookmarks`

## 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/teacher/courses/{course_id}/deck-bookmarks`
- Auth: OAuth 2 (password, token URL `api/login`)

Both decks of the course (course-level flashcards, knowledge-check
questions): their items in display order and each class's bookmark, its
effective position always filled in.

404: not a course of this teacher.

## Path parameters

- `course_id` string, required

## Response `200`

Successful Response

- CourseDeckBookmarksResponse
  - `flashcards` DeckBookmarksResponse, required: One deck: `item_ids` in display order (flashcard ids, or knowledge quiz `question_id`s), and the bookmark of each class concerned in the assignment's class order.
    - `item_ids` string[], required
    - `bookmarks` ClassDeckBookmarkResponse[], required
      - `class_id` string, required
      - `follows_course` boolean, required
      - `position` ItemBookmarkPosition, required: Where a deck bookmark sits: before the first item (`nothing`), after the last (`all`), or right after `item_id` (`item`), inclusive.
        - `kind` 'nothing' | 'all' | 'item', required
        - `item_id` string, nullable
      - `is_past` boolean, required
  - `quiz` DeckBookmarksResponse, required: One deck: `item_ids` in display order (flashcard ids, or knowledge quiz `question_id`s), and the bookmark of each class concerned in the assignment's class order.
    - `item_ids` string[], required
    - `bookmarks` ClassDeckBookmarkResponse[], required
      - `class_id` string, required
      - `follows_course` boolean, required
      - `position` ItemBookmarkPosition, required: Where a deck bookmark sits: before the first item (`nothing`), after the last (`all`), or right after `item_id` (`item`), inclusive.
        - `kind` 'nothing' | 'all' | 'item', required
        - `item_id` string, nullable
      - `is_past` boolean, required

## Other responses

- `400`: Malformed identifier
- `404`: Resource not found
- `422`: Validation Error

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-09-30** `518c1e6178a3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/teacher/courses/:course_id/deck-bookmarks/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)