Get all submissions for an assignment (lecturer/admin)

GET /api/v1/assignment/{id}/submissions

Retrieve all student submissions for a specific assignment with grading status and analytics.

Path parameters

id string Required

UUID of the assignment

Responses

200 application/json

List of submissions retrieved successfully
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
403

Forbidden - Admin or Lecturer role required
404

Assignment not found

GET /api/v1/assignment/{id}/submissions

curl \
 --request GET 'http://localhost:3500/api/v1/assignment/assignment-123/submissions'

Response examples (200)

{
  "graded": 30,
  "message": "Submissions retrieved",
  "pending": 15,
  "submissions": [
    {
      "id": "submission-456",
      "score": 85,
      "status": "GRADED",
      "studentId": "student-789",
      "aiAnalyzed": true,
      "studentName": "John Doe",
      "submittedAt": "2025-11-17T14:00:00Z"
    },
    {
      "id": "submission-457",
      "score": null,
      "status": "PENDING",
      "studentId": "student-790",
      "aiAnalyzed": false,
      "studentName": "Jane Smith",
      "submittedAt": "2025-11-17T15:30:00Z"
    }
  ],
  "totalSubmissions": 45
}

Response examples (400)

{
  "message": "string",
  "error": "string",
  "statusCode": 42.0
}