Assessments

Assessments

The Assessments endpoints return the exams administered in a school through K12NET's Measurement and Evaluation (Ölçme ve Değerlendirme) module, together with the students' scores, ranks and answers. They are available when the Organization has granted the Assessments permission to your Partner account for the school.

Only exams of the active school year whose results have been published are returned, and only students whose answers have been evaluated have results. Before an exam is published, the list endpoints return an empty list and the single-item endpoints return 204 No Content.

1. Exams of a School


POST https://api.k12net.com/INTCore.Web/api/Partner/Schools/{school_id}/Administrations

{
    "$skip": 0,
    "$take": 10
}

Returns the school's published exams, most recent first. A single call returns at most 10 exams; use $skip to read older ones. Always send a JSON body, even if it is only {}.


[
    { "ID": "cd8697dc-d37d-4f86-a66a-3b9edf1e303e", "Name": "8th Grade Mock Exam 3", "Date": "2026-11-11T00:00:00" }
]

Date is the date of the exam.

2. Results of All Students for an Exam


POST https://api.k12net.com/INTCore.Web/api/Partner/Administrations/{administration_id}/StudentResults

{
    "$skip": 0,
    "$take": 100
}

Pass an ID returned by the previous endpoint as {administration_id}. Returns the results of the students who took the exam, at most 100 per call; use $skip to read the rest. Each item has the same format as a single registration result (see below).

3. Exams a Student Took


POST https://api.k12net.com/INTCore.Web/api/Partner/Schools/{school_id}/Students/{student_id}/Registrations

{
    "$skip": 0,
    "$take": 100
}

Returns the student's evaluated registrations for the school's published exams, most recent first, at most 100 per call.


[
    {
        "ID": "dcf0848f-b93b-4b80-9039-08df461097f5",
        "StudentPersonalID": "6a64c9d0-011e-e411-93fd-6eae8b38b1b9",
        "AdministrationName": "8th Grade Mock Exam 3",
        "Date": "2026-11-19T10:07:16.823"
    }
]

Here Date is the date the exam was administered to the student's group, which can differ from the exam date returned by the Exams of a School endpoint.

4. Result of a Registration


GET https://api.k12net.com/INTCore.Web/api/Partner/Administrations/StudentResult/{registration_id}

Pass an ID returned by the previous endpoint as {registration_id}. The result contains one entry per test (subject) of the exam:


{
    "RegistrationID": "dcf0848f-b93b-4b80-9039-08df461097f5",
    "StudentPersonalID": "6a64c9d0-011e-e411-93fd-6eae8b38b1b9",
    "TestResults": [
        {
            "TestName": "Matematik",
            "TestScores": [
                { "Metric": "Doğru Sayısı", "Score": 6.0 },
                { "Metric": "Yanlış Sayısı", "Score": 4.0 },
                { "Metric": "Boş Sayısı", "Score": 0.0 },
                { "Metric": "Hatalı Sayısı", "Score": 0.0 },
                { "Metric": "Net Sayısı", "Score": 6.0 },
                { "Metric": "Net Yüzdesi", "Score": 60.0 }
            ],
            "TestRanks": [
                { "Rank": 3, "Count": 140, "Metric": "Net Yüzdesi", "Group": "Okul" },
                { "Rank": 1, "Count": 28, "Metric": "Net Yüzdesi", "Group": "Şube" }
            ],
            "Responses": [
                {
                    "Index": 1,
                    "Response": "B",
                    "Status": "Yanlış",
                    "Score": 0.0,
                    "StandardItems": [
                        { "Title": "Matematik Öğretim Programı", "Code": "M.8.1.1.1", "Statements": "Verilen pozitif tam sayıların çarpanlarını bulur." }
                    ]
                },
                { "Index": 2, "Response": "A", "Status": "Doğru", "Score": 1.0 }
            ]
        }
    ]
}

FieldDescription
TestNameName of the test (subject) within the exam.
TestScoresThe student's scores in the test. Metric is the score type: number of correct (Doğru), wrong (Yanlış), blank (Boş) and invalid (Hatalı) answers, net score (Net Sayısı) and net percentage (Net Yüzdesi), plus any other score types defined for the exam.
TestRanksThe student's rank (Rank) among Count students, by the given Metric. Group is Okul for the school, Şube for the homeroom, or the name of the wider group the rank was calculated in.
ResponsesOne entry per question in question order (Index): the student's answer, its evaluation (Doğru = correct, Yanlış = wrong), and the points earned.
Responses[].StandardItemsThe learning outcomes the question measures: the curriculum (Title), the outcome code and its statement. Left out when the question is not linked to a learning outcome.

Test, metric and status names are returned as recorded in K12NET, usually in Turkish. Empty lists are left out of the response, so a test without ranks has no TestRanks, and a registration whose scores have not been calculated yet has no TestResults. Responses may also contain the serializer properties $id and $type, which you can ignore.