Get an evaluated assignment score

GET

assignment-evaluation

assignment

{id}

answer-sheet

{ansSheetId}

score

Get an evaluated assignment score

curl --request GET \
  --url https://api.crazygoldfish.com/assignment-evaluation/v1/assignment/{id}/answer-sheet/{ansSheetId}/score/ \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.crazygoldfish.com/assignment-evaluation/v1/assignment/{id}/answer-sheet/{ansSheetId}/score/"

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/assignment-evaluation/v1/assignment/{id}/answer-sheet/{ansSheetId}/score/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "3c9e1f2a-7b4d-4a8e-9f1c-2d5e6a7b8c9d",
  "assignmentName": "Unit 3 English essay",
  "instruction": "Answer both parts in your own words.",
  "marks": 2,
  "grade": "7",
  "courseId": "300",
  "parentQuestions": [
    {
      "id": "cabb699a-ef46-447c-85d2-f320d83f9745",
      "questionNumber": "1",
      "text": "Read the passage and answer the questions.",
      "marks": 0,
      "questions": [
        {
          "id": "2edd8bfd-3616-4899-95e9-98d67489ca11",
          "questionNumber": "a",
          "text": "Why does the narrator return to the village?",
          "marks": 1,
          "diagramDescription": null,
          "modelAnswer": {
            "id": "d4f1a7c0-2b3e-4c5a-8d9f-0e1b2c3d4e5f",
            "stepMarking": [
              {
                "marksplit": 1,
                "step_wise_answer": "He returns to look after his grandmother.",
                "modelanswer_diagram_description": null
              }
            ],
            "rubric": null
          },
          "answer": {
            "id": "741cd09f-543f-460e-9b6e-826cf2809cb1",
            "text": "He goes back because his grandmother is ill and alone.",
            "marks": 1,
            "feedbacks": [
              {
                "feedback": "You identified the reason correctly and used your own words.",
                "student_text": "He goes back because his grandmother is ill and alone.",
                "justification": "The answer matches the model answer's single step.",
                "marks_deducted": "0",
                "room_for_improvement": "Quote one line from the passage to support the answer."
              }
            ],
            "holistic_evaluation": []
          }
        }
      ]
    }
  ]
}

Step 6 of 6 in Evaluate an assignment. Call it once the answer sheet’s status is 2 (Completed).

Every sub-question comes back with three parts: the question, its modelAnswer, and the student’s answer. A question the AI found no answer for has answer: {}.

Where the marks are

Answer submitted as	Read the marks from	Read the feedback from
Documents (PDF or images)	`answer.marks` on each question	`answer.feedbacks`, with `feedback`, `justification`, `marks_deducted`, and `room_for_improvement`
An audio link	`answer.holistic_evaluation.marks` out of `max_marks`	`answer.holistic_evaluation.evaluation`, one entry per rubric criterion, plus `overall_feedback`

For an audio answer, answer.marks stays 0 and answer.text holds the transcript of the recording.

The response has no obtained total. Add up answer.marks across the questions yourself, and compare it with marks on the assignment, which is the paper’s total.

This endpoint returns 400 while grading is still running, with Assignment sheet is not evaluated yet, and 400 with Assignment Answer sheet processing failed, please try again! if it failed. Poll List assignment answer sheets and read status instead.

Evaluate an assignment

The whole flow, with runnable code.

Async jobs and webhooks

Get told when a sheet is graded instead of polling.

Authorizations

Authorization

string

header

required

Access token from Get an access token.

Path Parameters

string<uuid>

required

The assignment id returned by Create an assignment. Use it exactly as returned: the lowercase form is the only one the nested paths accept.

Example:

"3c9e1f2a-7b4d-4a8e-9f1c-2d5e6a7b8c9d"

ansSheetId

string<uuid>

required

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

Example:

"6e1d2c3b-4a5f-4e6d-8c7b-9a0f1e2d3c4b"

Response

The evaluated answer sheet. There is no total: add up answer.marks yourself.

string<uuid>

ID of the assignment.

Example:

"3c9e1f2a-7b4d-4a8e-9f1c-2d5e6a7b8c9d"

assignmentName

string

Example:

"Unit 3 English essay"

instruction

string | null

Instructions the AI read from the paper.

Example:

"Answer both parts in your own words."

marks

number<float> | null

Total marks on the paper.

Example:

2

grade

string | null

Example:

"7"

courseId

string | null

Example:

"300"

parentQuestions

object[]

Show child attributes

Get an evaluated assignment score

curl --request GET \
  --url https://api.crazygoldfish.com/assignment-evaluation/v1/assignment/{id}/answer-sheet/{ansSheetId}/score/ \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.crazygoldfish.com/assignment-evaluation/v1/assignment/{id}/answer-sheet/{ansSheetId}/score/"

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/assignment-evaluation/v1/assignment/{id}/answer-sheet/{ansSheetId}/score/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "3c9e1f2a-7b4d-4a8e-9f1c-2d5e6a7b8c9d",
  "assignmentName": "Unit 3 English essay",
  "instruction": "Answer both parts in your own words.",
  "marks": 2,
  "grade": "7",
  "courseId": "300",
  "parentQuestions": [
    {
      "id": "cabb699a-ef46-447c-85d2-f320d83f9745",
      "questionNumber": "1",
      "text": "Read the passage and answer the questions.",
      "marks": 0,
      "questions": [
        {
          "id": "2edd8bfd-3616-4899-95e9-98d67489ca11",
          "questionNumber": "a",
          "text": "Why does the narrator return to the village?",
          "marks": 1,
          "diagramDescription": null,
          "modelAnswer": {
            "id": "d4f1a7c0-2b3e-4c5a-8d9f-0e1b2c3d4e5f",
            "stepMarking": [
              {
                "marksplit": 1,
                "step_wise_answer": "He returns to look after his grandmother.",
                "modelanswer_diagram_description": null
              }
            ],
            "rubric": null
          },
          "answer": {
            "id": "741cd09f-543f-460e-9b6e-826cf2809cb1",
            "text": "He goes back because his grandmother is ill and alone.",
            "marks": 1,
            "feedbacks": [
              {
                "feedback": "You identified the reason correctly and used your own words.",
                "student_text": "He goes back because his grandmother is ill and alone.",
                "justification": "The answer matches the model answer's single step.",
                "marks_deducted": "0",
                "room_for_improvement": "Quote one line from the passage to support the answer."
              }
            ],
            "holistic_evaluation": []
          }
        }
      ]
    }
  ]
}

Get started

Guides

Exam Evaluation

Assignment Evaluation

Rubrics

Action Plans

Lesson Plan Builder

Worksheet Builder

ClassTrack

Metadata

Webhooks

Get an evaluated assignment score

Where the marks are

Evaluate an assignment

Async jobs and webhooks

Authorizations

Path Parameters

Response

​Where the marks are

​Related

Evaluate an assignment

Async jobs and webhooks

Authorizations

Path Parameters

Response

Where the marks are

Related