Get Student Progress
get_student_progressRead-onlyIdempotent
Retrieve a student's current XP, level, streak status, and points balance to monitor learning progress and engagement.
Instructions
Retrieve a student's current XP, level, streak, and points balance.
Reads from Firestore (users/{studentId}), which is the system of record for gamification/progress data. Does NOT include quiz-level detail — use get_assessment_results for that.
Args:
student_id (string): The student's unique identifier.
Returns: JSON object with schema: { "studentId": string, "xp": number, "level": number, "streakCount": number, "streakStatus": "active" | "at_risk" | "broken", "pointsBalance": number }
Error Handling:
Returns "Student not found" if no Firestore user document exists for student_id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| student_id | Yes | The student's unique identifier (Firebase Auth UID / Supabase user_id — these are the same value across both systems). |