Get class mark entry progress

Get an overview of mark entry progress across all classes in an exam session. This endpoint provides: - Progress grouped by form and class - Average mark entry progress per class (calculated across all assigned subjects) - Count of subjects by status: not_started, in_progress, completed - Student count per class - Class teacher information Progress calculation: - For each subject: (marks with values / total marks) * 100 - Average for class: sum(all exam progress) / assigned subjects count Status categories: - not_started (0%): Exam not created OR students not confirmed OR no marks entered - in_progress (>0% and <100%): Some marks entered but not all - completed (100%): All marks entered for all students Use this endpoint to: - Monitor mark entry progress across the school - Identify classes with incomplete mark entry - Generate progress reports for administrators - Track which teachers need to complete mark entry

GET /api/v1/school/sessions/{session_pk}/exam-sessions/{exam_session_pk}/exams/class-mark-entry-progress

Get class mark entry progress

cURL

curl --request GET \
  --url https://api.example.com/api/v1/school/sessions/{session_pk}/exam-sessions/{exam_session_pk}/exams/class-mark-entry-progress/ \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "data": [
    {
      "form_id": "550e8400-e29b-41d4-a716-446655440001",
      "form_name": "Form 1",
      "form_level": "O Level",
      "classes": [
        {
          "class_id": "660e8400-e29b-41d4-a716-446655440001",
          "class_name": "1A",
          "class_teacher": "John Doe",
          "class_teacher_id": "770e8400-e29b-41d4-a716-446655440001",
          "student_count": 45,
          "assigned_subjects_count": 10,
          "not_started": 2,
          "in_progress": 5,
          "completed": 3,
          "average_mark_entry_progress": 65.5
        },
        {
          "class_id": "660e8400-e29b-41d4-a716-446655440002",
          "class_name": "1B",
          "class_teacher": null,
          "class_teacher_id": null,
          "student_count": 42,
          "assigned_subjects_count": 10,
          "not_started": 0,
          "in_progress": 3,
          "completed": 7,
          "average_mark_entry_progress": 85
        }
      ]
    },
    {
      "form_id": "550e8400-e29b-41d4-a716-446655440002",
      "form_name": "Form 2",
      "form_level": "O Level",
      "classes": [
        {
          "class_id": "660e8400-e29b-41d4-a716-446655440003",
          "class_name": "2A",
          "class_teacher": "Jane Smith",
          "class_teacher_id": "770e8400-e29b-41d4-a716-446655440002",
          "student_count": 38,
          "assigned_subjects_count": 12,
          "not_started": 1,
          "in_progress": 8,
          "completed": 3,
          "average_mark_entry_progress": 72.3
        }
      ]
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

exam_session_pk · string<uuid> · required

Exam Session ID

id · string<uuid> · required

Exam UUID

session_pk · string<uuid> · required

Academic Session ID

Response

200

application/json

{key} · any