Get exam scores for review

GET

evaluation-platform

exam

{examId}

answer-sheet

{ansSheetId}

pre-provisional-scores

Get exam scores for review

curl --request GET \
  --url https://api.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/pre-provisional-scores/ \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/pre-provisional-scores/"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/pre-provisional-scores/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "d19e6868-98dd-4274-a2a5-4a616dd93ea7",
  "examName": "Pre Board 1 - Science",
  "subjectName": "Science",
  "totalMarks": 80,
  "obtainedMarks": 45,
  "overallDuration": "180",
  "overallInstruction": "All questions are compulsory. Section A has 20 questions of 1 mark each.",
  "sections": [
    {
      "id": "ef66afc6-d923-43c6-b2d2-e29814306214",
      "sectionName": "SECTION A",
      "duration": null,
      "instruction": null,
      "totalQuestion": 20,
      "maxQuestionAttempt": 20,
      "totalMarks": 20,
      "obtainedMarks": 13,
      "parentQuestions": [
        {
          "id": "fcb22595-c36a-4ddf-b9d3-00ba6d2ea466",
          "text": "Identify the option that gives the correct enzyme secreted at locations (i), (ii) and (iii).",
          "questionNumber": "Q1",
          "questionType": "MCQ",
          "isQuestionMarkMismatch": false,
          "totalQuestion": 1,
          "maxQuestionAttempt": 1,
          "marks": 1,
          "obtainedMarks": 0,
          "questions": [
            {
              "id": "226986d3-95e4-4ed7-aaa4-3e7054f9bc5b",
              "text": "(a) (i) lipase (ii) trypsin (iii) pepsin\n(b) (i) amylase (ii) pepsin (iii) trypsin",
              "marks": 1,
              "isApproved": false,
              "questionNumber": "",
              "isModelAnswerMarkMismatch": false,
              "diagramDescription": null,
              "supportingText": "MCQ",
              "modelAnswer": {
                "id": "57837640-c695-44a5-9667-9cfb8bafebf1",
                "answerText": "(b) (i) amylase, (ii) pepsin, (iii) trypsin",
                "stepMarking": [
                  {
                    "marksplit": 1,
                    "step_wise_answer": "(b) (i) amylase, (ii) pepsin, (iii) trypsin",
                    "modelanswer_diagram_description": null
                  }
                ]
              },
              "answer": [
                {
                  "id": "f819bfd2-8aaa-42df-bd18-23cb989b2d16",
                  "answerText": "(a) (i) amylase, (ii) pepsin, (iii) pepsin",
                  "marks": 0,
                  "isApproved": false,
                  "diagramDescription": null,
                  "aiFeedbacks": [
                    {
                      "feedback": "The enzyme for location (iii) is trypsin, not pepsin.",
                      "student_text": "(a) (i) amylase, (ii) pepsin, (iii) pepsin",
                      "justification": "Pepsin acts in the stomach, so it cannot be the enzyme at location (iii).",
                      "marks_deducted": "1",
                      "room_for_improvement": "Revise which enzyme each digestive organ secretes."
                    }
                  ],
                  "teacherFeedback": null
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Step 6 of 8 in Evaluate an exam. This is also how you wait for evaluation to finish.

These scores are not published. Show them to a teacher, not to a student. Students read Get provisional exam scores after you publish.

Reading the response

Response	Meaning	What to do
`200`	The sheet is graded	Show it for review
`400` `Answer Sheet is not evaluated yet!`	Still evaluating	Check again in 5 seconds
`400` `Answer Sheet processing failed, please try again!`	Evaluation failed	Create a new answer sheet and upload the pages again
`404` `Answer Sheet not found`	Unknown answer sheet ID	Check the ID

The body is the question paper with three things added to every question:

modelAnswer: the answer key and its step marking.
answer: what the student wrote, the marks awarded, and aiFeedbacks explaining every deduction.
obtainedMarks: the running total on each question group, each section, and the exam.

answerText is No Answer when the student left a question blank, and those answers always score 0.

Next step

Edit exam questions, answers, or marks

Correct anything the AI got wrong.

Publish exam results

Let students read their scores.

Authorizations

Authorization

string

header

required

Access token from Get an access token. A missing, invalid, or expired token returns 403.

Path Parameters

examId

string<uuid>

required

The exam id returned by Create an exam.

Example:

"d19e6868-98dd-4274-a2a5-4a616dd93ea7"

ansSheetId

string<uuid>

required

The answer sheet id returned by Create an exam answer sheet.

Example:

"8a2f4c1e-5b3d-4e6f-9a7b-0c1d2e3f4a5b"

Response

The scored paper. Students must not see this before you publish.

The question paper with the model answer, the student's answer, and marks for every question.

string<uuid>

The exam ID.

examName

string | null

subjectName

string | null

totalMarks

integer | null

obtainedMarks

number<float>

Total marks the student scored, after any choice rules are applied.

overallDuration

string | null

overallInstruction

string | null

sections

object[]

Show child attributes

Get exam scores for review

curl --request GET \
  --url https://api.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/pre-provisional-scores/ \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/pre-provisional-scores/"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/pre-provisional-scores/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "d19e6868-98dd-4274-a2a5-4a616dd93ea7",
  "examName": "Pre Board 1 - Science",
  "subjectName": "Science",
  "totalMarks": 80,
  "obtainedMarks": 45,
  "overallDuration": "180",
  "overallInstruction": "All questions are compulsory. Section A has 20 questions of 1 mark each.",
  "sections": [
    {
      "id": "ef66afc6-d923-43c6-b2d2-e29814306214",
      "sectionName": "SECTION A",
      "duration": null,
      "instruction": null,
      "totalQuestion": 20,
      "maxQuestionAttempt": 20,
      "totalMarks": 20,
      "obtainedMarks": 13,
      "parentQuestions": [
        {
          "id": "fcb22595-c36a-4ddf-b9d3-00ba6d2ea466",
          "text": "Identify the option that gives the correct enzyme secreted at locations (i), (ii) and (iii).",
          "questionNumber": "Q1",
          "questionType": "MCQ",
          "isQuestionMarkMismatch": false,
          "totalQuestion": 1,
          "maxQuestionAttempt": 1,
          "marks": 1,
          "obtainedMarks": 0,
          "questions": [
            {
              "id": "226986d3-95e4-4ed7-aaa4-3e7054f9bc5b",
              "text": "(a) (i) lipase (ii) trypsin (iii) pepsin\n(b) (i) amylase (ii) pepsin (iii) trypsin",
              "marks": 1,
              "isApproved": false,
              "questionNumber": "",
              "isModelAnswerMarkMismatch": false,
              "diagramDescription": null,
              "supportingText": "MCQ",
              "modelAnswer": {
                "id": "57837640-c695-44a5-9667-9cfb8bafebf1",
                "answerText": "(b) (i) amylase, (ii) pepsin, (iii) trypsin",
                "stepMarking": [
                  {
                    "marksplit": 1,
                    "step_wise_answer": "(b) (i) amylase, (ii) pepsin, (iii) trypsin",
                    "modelanswer_diagram_description": null
                  }
                ]
              },
              "answer": [
                {
                  "id": "f819bfd2-8aaa-42df-bd18-23cb989b2d16",
                  "answerText": "(a) (i) amylase, (ii) pepsin, (iii) pepsin",
                  "marks": 0,
                  "isApproved": false,
                  "diagramDescription": null,
                  "aiFeedbacks": [
                    {
                      "feedback": "The enzyme for location (iii) is trypsin, not pepsin.",
                      "student_text": "(a) (i) amylase, (ii) pepsin, (iii) pepsin",
                      "justification": "Pepsin acts in the stomach, so it cannot be the enzyme at location (iii).",
                      "marks_deducted": "1",
                      "room_for_improvement": "Revise which enzyme each digestive organ secretes."
                    }
                  ],
                  "teacherFeedback": null
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Get started

Guides

Exam Evaluation

Assignment Evaluation

Rubrics

Action Plans

Lesson Plan Builder

Worksheet Builder

ClassTrack

Metadata

Webhooks

Get exam scores for review

Reading the response

Next step

Edit exam questions, answers, or marks

Publish exam results

Authorizations

Path Parameters

Response

​Reading the response

​Next step

Edit exam questions, answers, or marks

Publish exam results

Authorizations

Path Parameters

Response

Reading the response

Next step