Retrieve comprehensive information about a specific unit the student is enrolled in, including all topics, lessons, assignments, exams, resources, and progress tracking. This is the main view when a student selects a unit from their dashboard.
GET
/api/v1/student/{studentId}/units/{studentUnitId}
curl \
--request GET 'http://localhost:3500/api/v1/student/uuid-string/units/uuid-string'
Response examples (200)
{
"message": "string",
"success": true,
"unit": {
"studentUnitId": "uuid-string",
"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"
}
},
"status": "ACTIVE",
"topics": [
{
"id": "uuid-string",
"title": "Data Structures Fundamentals",
"description": "string",
"order": 1,
"lessons": [
{
"id": "uuid-string",
"title": "Introduction to Arrays",
"description": "Learn about array data structures",
"order": 1,
"content": [
{
"id": "uuid-string",
"content": "This lesson covers...",
"order": 1,
"createdAt": "2025-09-25T10:30:00.000Z",
"updatedAt": "2025-09-25T10:30:00.000Z"
}
],
"resources": [
{
"id": "uuid-string",
"title": "Lecture Notes Chapter 1",
"url": "https://example.com/resource.pdf",
"type": "PDF",
"createdAt": "2025-09-25T10:30:00.000Z"
}
],
"isCompleted": false,
"progress": 50,
"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"
}
],
"onlineLessons": [
{
"id": "uuid-string",
"title": "Live Lecture - Week 3",
"description": "string",
"link": "string",
"passcode": "string",
"createdAt": "2025-09-25T10:30:00.000Z"
}
],
"assignments": [
{
"id": "uuid-string",
"title": "Programming Assignment 1",
"description": "Implement a binary search tree",
"releaseDate": "2025-10-01T00:00:00.000Z",
"dueDate": "2025-10-15T23:59:59.000Z",
"marks": 15,
"status": "string",
"createdAt": "2025-09-25T10:30:00.000Z",
"updatedAt": "2025-09-25T10:30:00.000Z"
}
],
"exams": [
{
"id": "uuid-string",
"title": "Final Examination",
"description": "Final comprehensive exam",
"scheduledDate": "2025-12-01T09:00:00.000Z",
"duration": 180,
"totalMarks": 60,
"status": "string",
"createdAt": "2025-09-25T10:30:00.000Z",
"updatedAt": "2025-09-25T10:30:00.000Z"
}
],
"resources": [
{
"id": "uuid-string",
"title": "Lecture Notes Chapter 1",
"url": "https://example.com/resource.pdf",
"type": "PDF",
"createdAt": "2025-09-25T10:30:00.000Z"
}
],
"lastLessonId": "string",
"overallProgress": 45,
"createdAt": "2025-09-25T10:30:00.000Z",
"updatedAt": "2025-09-25T10:30:00.000Z"
}
}