Retrieve assessments with advanced filtering options including status, unit offering ID, student unit ID, type, and pagination with sorting capabilities
Query parameters
-
Assessment status filter
Values are
ARCHIVED,DRAFT,COMPLETED,RELEASED,GRADED,UPCOMING, orACTIVE. -
Unit offering ID filter
-
Student unit ID filter
-
Assessment type filter
Values are
assignment,cat, orexam. -
Page number for pagination
Minimum value is
1. -
Number of items per page
Minimum value is
1, maximum value is100. -
Sort by field
Values are
dueDate,title,status, ortype. -
Sort order
Values are
ascordesc.
GET
/api/v1/student/{studentId}/assessments
curl \
--request GET 'http://localhost:3500/api/v1/student/uuid-string/assessments'
Response examples (200)
{
"message": "string",
"success": true,
"assessments": [
{
"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",
"description": "Complete the programming assignment on data structures",
"releaseDate": "2025-10-01T00:00:00.000Z",
"durationMinutes": 120,
"maxAttempts": 3,
"attemptsUsed": 1,
"bestScore": 85,
"latestScore": 90,
"canAttempt": true,
"unitOfferingId": "uuid-string"
}
],
"totalCount": 25,
"currentPage": 1,
"totalPages": 3,
"itemsPerPage": 10
}
Response examples (400)
{
"message": "string",
"error": "string",
"statusCode": 42.0
}