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

Retrieve comprehensive assessment statistics including status breakdown, type distribution, performance metrics, and completion rates

Path parameters

  • studentId string Required

    Unique identifier of the student

Responses

  • 200 application/json

    Assessment statistics retrieved successfully

    Hide response attributes Show response attributes object
    • message string Required

      Success message

    • success boolean Required

      Success status

    • byStatus array[object] Required

      Assessment statistics by status

      Hide byStatus attributes Show byStatus attributes object
      • status string Required

        Status

      • count number Required

        Count

      • percentage number Required

        Percentage

    • byType array[object] Required

      Assessment statistics by type

      Hide byType attributes Show byType attributes object
      • type string Required

        Assessment type

      • count number Required

        Count

      • percentage number Required

        Percentage

    • performance object Required

      Assessment performance statistics

      Hide performance attributes Show performance attributes object
      • totalAttempted number Required

        Total assessments attempted

      • totalCompleted number Required

        Total assessments completed

      • averageScore number Required

        Average score across all assessments

      • highestScore number Required

        Highest score achieved

      • lowestScore number Required

        Lowest score achieved

      • pendingCount number Required

        Pending assessments count

      • overdueCount number Required

        Overdue assessments count

  • 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/statistics
curl \
 --request GET 'http://localhost:3500/api/v1/student/uuid-string/assessments/statistics'
Response examples (200)
{
  "message": "string",
  "success": true,
  "byStatus": [
    {
      "status": "RELEASED",
      "count": 5,
      "percentage": 25.5
    }
  ],
  "byType": [
    {
      "type": "assignment",
      "count": 8,
      "percentage": 40
    }
  ],
  "performance": {
    "totalAttempted": 12,
    "totalCompleted": 10,
    "averageScore": 78.5,
    "highestScore": 95,
    "lowestScore": 62,
    "pendingCount": 3,
    "overdueCount": 1
  }
}
Response examples (400)
{
  "message": "string",
  "error": "string",
  "statusCode": 42.0
}