GET /api/v1/unit-instance/{unit}/assignments

Retrieve assignments for a unit filtered by access level (visibility). HIGH level returns all assignments, NORMAL returns student-accessible assignments.

Path parameters

  • unit string Required

    UUID of the unit instance (unit offering)

Query parameters

  • level string

    Access level filter - HIGH: all assignments, NORMAL: published assignments, LOW: draft assignments

    Values are HIGH, NORMAL, or LOW.

Responses

  • 200 application/json

    Assignments 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
  • 404

    Unit not found

GET /api/v1/unit-instance/{unit}/assignments
curl \
 --request GET 'https://api.echoplain.social/api/v1/unit-instance/123e4567-e89b-12d3-a456-426614174000/assignments'
Response examples (200)
{
  "unitId": "123e4567-e89b-12d3-a456-426614174000",
  "accessLevel": "HIGH",
  "assignments": [
    {
      "id": "assignment-321",
      "title": "Algorithm Implementation",
      "status": "ACTIVE",
      "dueDate": "2025-11-30T23:59:59Z",
      "maxScore": 100,
      "submissionsCount": 25
    },
    {
      "id": "assignment-322",
      "title": "Data Structures Project",
      "status": "DRAFT",
      "dueDate": "2025-12-15T23:59:59Z",
      "maxScore": 150,
      "submissionsCount": 0
    }
  ],
  "totalAssignments": 3
}
Response examples (400)
{
  "message": "string",
  "error": "string",
  "statusCode": 42.0
}