GET /api/v1/student/{studentId}/assessments

Retrieve assessments with advanced filtering options including status, unit offering ID, student unit ID, type, and pagination with sorting capabilities

Path parameters

  • studentId string Required

    Unique identifier of the student

Query parameters

  • status string

    Assessment status filter

    Values are ARCHIVED, DRAFT, COMPLETED, RELEASED, GRADED, UPCOMING, or ACTIVE.

  • unitOfferingId string

    Unit offering ID filter

  • studentUnitId string

    Student unit ID filter

  • type string

    Assessment type filter

    Values are assignment, cat, or exam.

  • page number

    Page number for pagination

    Minimum value is 1.

  • limit number

    Number of items per page

    Minimum value is 1, maximum value is 100.

  • sortBy string

    Sort by field

    Values are dueDate, title, status, or type.

  • sortOrder string

    Sort order

    Values are asc or desc.

Responses

  • 200 application/json

    Filtered assessments retrieved successfully

    Hide response attributes Show response attributes object
    • message string Required

      Success message

    • success boolean Required

      Success status

    • assessments array[object] Required

      Filtered assessments

      Hide assessments attributes Show assessments attributes object
      • id string Required

        Assessment ID

      • title string Required

        Assessment title

      • type string Required

        Assessment type

        Values are assignment, cat, or exam.

      • unitCode string Required

        Unit code

      • unitTitle string Required

        Unit title

      • dueDate string Required

        Due date

      • daysRemaining number Required

        Days remaining

      • totalMarks number Required

        Total marks

      • status string Required

        Status

      • description string Required

        Assessment description

      • releaseDate string Required

        Release date

      • durationMinutes number

        Duration in minutes

      • maxAttempts number Required

        Maximum attempts allowed

      • attemptsUsed number Required

        Student attempts made

      • bestScore number

        Best score achieved

      • latestScore number

        Latest score achieved

      • canAttempt boolean Required

        Can attempt assessment

      • unitOfferingId string Required

        Unit offering ID

    • totalCount number Required

      Total count of assessments

    • currentPage number Required

      Current page

    • totalPages number Required

      Total pages

    • itemsPerPage number Required

      Items per page

  • 400 application/json

    Default bad request error 400 response

    Hide response attributes Show response attributes object
    • message string Required

      Response message

    • error string Required
    • statusCode number Required
  • 404

    Student not found

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
}