Result & Publishing

GET - Pre-Provisional Scores

This API allows teachers to review detailed pre-provisional scores for an answer sheet associated with a specific exam. It includes section-wise and question-level details, evaluator feedback, and mechanisms for teachers to approve or adjust scores before they are released as provisional scores.

The GET Pre-Provisional Scores API retrieves preliminary scores for a student’s exam, including:

Exam-level metadata such as total and obtained marks.
Section-level details with allocated and achieved marks.
Question-level insights, including model answers, student answers, feedback, and step-wise marking.

Scenarios:

AI Reviewing and Scoring the Student’s Answer Sheet:
- After submission, the AI reviews the answer sheet, processes the answers, and assigns preliminary scores according to section and question-specific marks.
- API Provides:
  - Exam-Level Metadata: Total marks, obtained marks, and overall feedback.
  - Section-Level Scores: Marks allocated and achieved for each section.
  - Question-Level Details: AI’s scoring based on model answers, step-wise marking, and feedback.
- Outcome:
  - AI generates pre-provisional scores, offering insights into how the model answer aligns with the student’s response.
  - The teacher can review and adjust scores before finalizing them.
Reviewing AI’s Marking and Feedback Before Provisional Score Release:
- The teacher reviews the AI-generated pre-provisional scores.
- The API displays AI feedback and scores calculated according to step-wise marking.
- Outcome:
  - The teacher assesses AI feedback on each question and adjusts any scores before finalizing and releasing the provisional score.

GET

evaluation-platform

exam

{examId}

answer-sheet

{ansSheetId}

pre-provisional-scores

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

{
  "id": "4340132f-50fa-4877-9ffa-e9b7ee59d51f",
  "examName": "CBSE 10 – Mock Test",
  "subjectName": "Science",
  "totalMarks": 80,
  "obtainedMarks": 45,
  "questionMarkSumMismatch": false,
  "modelAnswerMarkSumMismatch": false,
  "overallDuration": "180",
  "overallInstruction": "1. All questions would be compulsory. However, an internal choice of approximately 33% would be provided. 50% marks are to be allotted to competency-based questions. 2. Section A would have 16 simple/complex MCQs and 04 Assertion-Reasoning type questions carrying 1 mark each. 3. Section B would have 6 Short Answer (SA) type questions carrying 02 marks each. 4. Section C would have 7 Short Answer (SA) type questions carrying 03 marks each. 5. Section D would have 3 Long Answer (SA) type questions carrying 05 marks each. 6. Section E would have 3 source based/case based/passage based/integrated units of assessment (04 marks each) with sub-parts of the values of 1/2/3 marks.",
  "sections": [
    {
      "id": "ef66afc6-d923-43c6-b2d2-e29814306214",
      "sectionName": "SECTION A",
      "duration": null,
      "instruction": null,
      "totalMarks": 20,
      "obtainedMarks": 13,
      "parentQuestions": [
        {
          "id": "fcb22595-c36a-4ddf-b9d3-00ba6d2ea466",
          "text": "Identify the option that indicates the correct enzyme that is secreted in location i, ii and iii.",
          "marks": 1,
          "questionNumber": "Q1",
          "questionType": null,
          "questions": [
            {
              "id": "226986d3-95e4-4ed7-aaa4-3e7054f9bc5b",
              "text": "(a) (i)Lipase, (ii) trypsin (iii) pepsin (b) (i) amylase, (ii) pepsin, (iii) trypsin (c) (i) trypsin, (ii) amylase, (iii) carboxylase (d) (i) permease (ii) carboxylase (iii) oxidase",
              "marks": 1,
              "isApproved": false,
              "questionNumber": "",
              "diagramDescription": null,
              "supportingText": "MCQ",
              "modelAnswer": {
                "id": "57837640-c695-44a5-9667-9cfb8bafebf1",
                "answerText": "",
                "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": "(b) (i) amylase , (ii) pepsin, (iii) Trypsin",
                  "marks": 1,
                  "isApproved": false,
                  "diagramDescription": null,
                  "aiFeedbacks": [
                    {
                      "feedback": "The student has provided the correct answer, demonstrating a clear understanding of the enzymes associated with the specified locations. Great job!",
                      "student_text": "(b) (i) amylase , (ii) pepsin, (iii) Trypsin",
                      "justification": "The student's answer matches the model answer exactly, indicating that they have correctly identified the enzymes for each location as per the question requirements.",
                      "marks_deducted": "0",
                      "room_for_improvement": "None, as the answer is correct and complete."
                    }
                  ],
                  "teacherFeedback": "The student has provided the correct answer, demonstrating a clear understanding of the enzymes associated with the specified locations. Great job!"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

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

Path Parameters

examId

string

required

ansSheetId

string

required

Response

200

application/json

Success

string

Unique identifier of the exam

Example:

"4340132f-50fa-4877-9ffa-e9b7ee59d51f"

examName

string

Exam Name

Example:

"CBSE 10 – Mock Test"

subjectName

string

Subject Name

Example:

"Science"

totalMarks

number

Total marks of the exam

Example:

80

obtainedMarks

number

Marks obtained by the student

Example:

45

questionMarkSumMismatch

boolean

Flag to indicate if the sum of the marks of the questions is not equal to the total marks of the exam

Example:

false

modelAnswerMarkSumMismatch

boolean

Flag to indicate if the sum of the marks of the model answers is not equal to the total marks of the exam

Example:

false

overallDuration

string

Duration of the exam

Example:

"180"

overallInstruction

string

Instruction given for the exam

Example:

"1. All questions would be compulsory. However, an internal choice of approximately 33% would be provided. 50% marks are to be allotted to competency-based questions. 2. Section A would have 16 simple/complex MCQs and 04 Assertion-Reasoning type questions carrying 1 mark each. 3. Section B would have 6 Short Answer (SA) type questions carrying 02 marks each. 4. Section C would have 7 Short Answer (SA) type questions carrying 03 marks each. 5. Section D would have 3 Long Answer (SA) type questions carrying 05 marks each. 6. Section E would have 3 source based/case based/passage based/integrated units of assessment (04 marks each) with sub-parts of the values of 1/2/3 marks."

sections

object[]

List of sections in the exam

sections.id

string

Unique identifier of the section

Example:

"ef66afc6-d923-43c6-b2d2-e29814306214"

sections.sectionName

string

Name of the section

Example:

"SECTION A"

sections.duration

string

Duration of the section

Example:

null

sections.instruction

string

Instruction given for the section

Example:

null

sections.totalMarks

number

Total marks of the section

Example:

20

sections.obtainedMarks

number

Marks obtained by the student

Example:

13

sections.parentQuestions

object[]

List of parent questions in the section

sections.parentQuestions.id

string

Unique identifier of the parent question

Example:

"fcb22595-c36a-4ddf-b9d3-00ba6d2ea466"

sections.parentQuestions.text

string

Text of the parent question

Example:

"Identify the option that indicates the correct enzyme that is secreted in location i, ii and iii."

sections.parentQuestions.marks

integer

Marks of the parent question

Example:

1

sections.parentQuestions.questionNumber

string

Question number

Example:

"Q1"

sections.parentQuestions.questionType

string

Type of the question

Example:

"MCQ"

sections.parentQuestions.questions

object[]

GET - Student Answer Sheet List POST - Publish Result

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

{
  "id": "4340132f-50fa-4877-9ffa-e9b7ee59d51f",
  "examName": "CBSE 10 – Mock Test",
  "subjectName": "Science",
  "totalMarks": 80,
  "obtainedMarks": 45,
  "questionMarkSumMismatch": false,
  "modelAnswerMarkSumMismatch": false,
  "overallDuration": "180",
  "overallInstruction": "1. All questions would be compulsory. However, an internal choice of approximately 33% would be provided. 50% marks are to be allotted to competency-based questions. 2. Section A would have 16 simple/complex MCQs and 04 Assertion-Reasoning type questions carrying 1 mark each. 3. Section B would have 6 Short Answer (SA) type questions carrying 02 marks each. 4. Section C would have 7 Short Answer (SA) type questions carrying 03 marks each. 5. Section D would have 3 Long Answer (SA) type questions carrying 05 marks each. 6. Section E would have 3 source based/case based/passage based/integrated units of assessment (04 marks each) with sub-parts of the values of 1/2/3 marks.",
  "sections": [
    {
      "id": "ef66afc6-d923-43c6-b2d2-e29814306214",
      "sectionName": "SECTION A",
      "duration": null,
      "instruction": null,
      "totalMarks": 20,
      "obtainedMarks": 13,
      "parentQuestions": [
        {
          "id": "fcb22595-c36a-4ddf-b9d3-00ba6d2ea466",
          "text": "Identify the option that indicates the correct enzyme that is secreted in location i, ii and iii.",
          "marks": 1,
          "questionNumber": "Q1",
          "questionType": null,
          "questions": [
            {
              "id": "226986d3-95e4-4ed7-aaa4-3e7054f9bc5b",
              "text": "(a) (i)Lipase, (ii) trypsin (iii) pepsin (b) (i) amylase, (ii) pepsin, (iii) trypsin (c) (i) trypsin, (ii) amylase, (iii) carboxylase (d) (i) permease (ii) carboxylase (iii) oxidase",
              "marks": 1,
              "isApproved": false,
              "questionNumber": "",
              "diagramDescription": null,
              "supportingText": "MCQ",
              "modelAnswer": {
                "id": "57837640-c695-44a5-9667-9cfb8bafebf1",
                "answerText": "",
                "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": "(b) (i) amylase , (ii) pepsin, (iii) Trypsin",
                  "marks": 1,
                  "isApproved": false,
                  "diagramDescription": null,
                  "aiFeedbacks": [
                    {
                      "feedback": "The student has provided the correct answer, demonstrating a clear understanding of the enzymes associated with the specified locations. Great job!",
                      "student_text": "(b) (i) amylase , (ii) pepsin, (iii) Trypsin",
                      "justification": "The student's answer matches the model answer exactly, indicating that they have correctly identified the enzymes for each location as per the question requirements.",
                      "marks_deducted": "0",
                      "room_for_improvement": "None, as the answer is correct and complete."
                    }
                  ],
                  "teacherFeedback": "The student has provided the correct answer, demonstrating a clear understanding of the enzymes associated with the specified locations. Great job!"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Authentication

K12

Assessment Rubrics

Standardized Language Exams

GET - Pre-Provisional Scores

Authorizations

Path Parameters

Response