Attempt history

After a student completes one or more lesson attempts, you can retrieve their history and review per-question results. This is useful for building review screens, progress dashboards, or retry flows.

List past attempts

Call lessons.attempts() to get all attempts for a lesson:

const attempts = await timeback.lessons.attempts({
	lessonId: lesson.id,
})

Each attempt includes attempt number, score, finalized status, totalQuestions, and correctQuestions.

See the reference for the full return type.

Get attempt details

To see per-question data for a specific attempt, call lessons.attemptDetails():

const details = await timeback.lessons.attemptDetails({
	lessonId: lesson.id,
	attempt: 1,
})

Extract questions

Use getLessonAttemptQuestions() to get a flat list of questions from the response:

import { getLessonAttemptQuestions } from '@timeback/sdk'

const questions = getLessonAttemptQuestions(details)

Each question includes id, correct, studentResponse, and content.rawXml for re-rendering.

See the reference for full type documentation.

Why do I need a helper for this?

The raw response shape differs by lesson type. Adaptive lessons (powerpath-100) return seenQuestions, which is only the questions PowerPath actually served (the count varies per student). Linear lessons (quiz, test-out, etc.) return questions, which is the full fixed set for the attempt.getLessonAttemptQuestions() normalizes both into a single LessonAttemptQuestion[]. If you need to distinguish the two (e.g., to show “X of Y questions seen” for adaptive lessons), check details.lessonType and access the raw fields directly.

Build a review screen

A typical review flow:

// 1. Load attempts
const attempts = await timeback.lessons.attempts({ lessonId })

// 2. Let the student pick an attempt to review
const selected = attempts[0]

// 3. Load details
const details = await timeback.lessons.attemptDetails({
	lessonId,
	attempt: selected.attempt,
})

// 4. Get questions
const questions = getLessonAttemptQuestions(details)

// 5. Render review cards
for (const q of questions) {
	renderReviewCard({
		questionXml: q.content.rawXml,
		studentAnswer: q.studentResponse,
		wasCorrect: q.correct,
	})
}

Getting Started

CLI

SDK

Reference

List past attempts

Get attempt details

Extract questions

Build a review screen

Next steps

Lesson discovery

Reference

​List past attempts

​Get attempt details

​Extract questions

​Build a review screen

​Next steps

Lesson discovery

Reference

List past attempts

Get attempt details

Extract questions

Build a review screen

Next steps