Retrieve comprehensive student dashboard with profile, statistics, active units, upcoming assessments, recent grades, and notifications - everything a student LMS dashboard should have
GET
/api/v1/student/{studentId}/dashboard
curl \
--request GET 'http://localhost:3500/api/v1/student/uuid-string/dashboard'
Response examples (200)
{
"message": "string",
"success": true,
"dashboard": {
"profile": {
"id": "uuid-string",
"fullName": "John Doe",
"phone": "+1234567890",
"createdAt": "2025-09-25T10:30:00.000Z",
"updatedAt": "2025-09-25T10:30:00.000Z"
},
"stats": {
"totalActiveUnits": 5,
"completedUnits": 12,
"failedUnits": 1,
"currentGPA": 3.5,
"overallGPA": 3.2,
"pendingAssignments": 3,
"upcomingExams": 2,
"unreadNotifications": 5
},
"activeUnits": [
{
"id": "uuid-string",
"unit": {
"id": "uuid-string",
"Code": "CS201",
"personalizedOutline": "string",
"unitVersion": {
"id": "uuid-string",
"title": "Data Structures and Algorithms",
"description": "Introduction to data structures and algorithms",
"totalMarks": 100,
"examMarks": 60,
"otherMarks": 40,
"hasLabs": true
},
"semester": {
"id": "uuid-string",
"name": "Fall 2023",
"shortCode": "F23",
"startDate": "2023-09-01T00:00:00.000Z",
"endDate": "2023-12-31T23:59:59.000Z"
},
"lecturer": {
"id": "uuid-string",
"userId": "uuid-string",
"user": {
"id": "uuid-string",
"email": "student@example.com",
"role": "STUDENT",
"status": "ACTIVE",
"profile": {
"id": "uuid-string",
"fullName": "John Doe",
"phone": "+1234567890",
"createdAt": "2025-09-25T10:30:00.000Z",
"updatedAt": "2025-09-25T10:30:00.000Z"
},
"createdAt": "2025-09-25T10:30:00.000Z",
"updatedAt": "2025-09-25T10:30:00.000Z"
}
},
"studentGroupingsEnabled": false,
"createdAt": "2025-09-25T10:30:00.000Z",
"updatedAt": "2025-09-25T10:30:00.000Z"
},
"status": "ACTIVE",
"createdAt": "2025-09-25T10:30:00.000Z",
"updatedAt": "2025-09-25T10:30:00.000Z"
}
],
"upcomingAssessments": [
{
"id": "uuid-string",
"title": "Programming Assignment 1",
"type": "assignment",
"unitCode": "CS201",
"unitTitle": "Data Structures and Algorithms",
"dueDate": "2025-10-15T23:59:59.000Z",
"daysRemaining": 5,
"totalMarks": 15,
"status": "string"
}
],
"recentGrades": [
{
"id": "uuid-string",
"unitCode": "CS201",
"unitTitle": "Data Structures and Algorithms",
"assessmentType": "assignment",
"score": 85.5,
"grade": "A",
"createdAt": "2025-09-25T10:30:00.000Z"
}
],
"recentNotifications": [
{
"id": "uuid-string",
"title": "Assignment Due",
"message": "Your assignment is due tomorrow",
"isRead": false,
"createdAt": "2025-09-25T10:30:00.000Z"
}
]
}
}
Response examples (400)
{
"message": "string",
"error": "string",
"statusCode": 42.0
}