Create School Tests Student Records | SchoolSet

curl -X POST https://app.schoolset.io/app/api/v1/school-tests/student/student_id/records \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "academic_year_id": 2024
}'

{
  "status": "success",
  "message": "School test records retrieved successfully.",
  "data": [
    {
      "id": 1024,
      "school_test_event_id": 58,
      "event_date": "2024-04-15",
      "school_test_id": 305,
      "test_name": "Midterm Mathematics Exam",
      "test_type_name": "Written Exam",
      "subject_name": "Mathematics",
      "score_value": "88%",
      "comments": "Good performance, needs improvement in algebra.",
      "test_file": {
        "id": 789,
        "url": "https://app.schoolset.io/files/tests/789.pdf",
        "name": "Midterm_Math_Exam_2024.pdf"
      }
    }
  ]
}

Returns or records school-test scores for the selected student.

Authentication

AuthorizationBearer

You can retrieve your token by visiting your dashboard and clicking Generate API token.

Path parameters

student_idstringRequired

Request

This endpoint expects an object.

academic_year_idintegerRequired

academic year ID identifier.

start_datestring or nullOptional

Must be a valid date.

end_datestring or nullOptional

Must be a valid date. Must be a date after or equal to start_date.

Response

Successful POST response for /api/v1/school-tests/student/{student_id}/records.

statusenum

Allowed values:

messagestring

datalist of objects