> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crazygoldfish.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 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:**
1. **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.
2. **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.
Want to receive automatic notifications when student answer sheets are processed? Set up webhooks to get real-time updates on student answer extraction. Check out the [Webhooks](/api-reference/endpoint/webhook/v1-get-webhook-template).
## OpenAPI
````yaml GET /evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/pre-provisional-scores/
openapi: 3.0.1
info:
title: Evaluation Report API
description: An API for retrieving evaluation reports.
version: 1.0.0
servers:
- url: https://api-staging.crazygoldfish.com
description: SandBox endpoint
- url: https://api.crazygoldfish.com
description: Prod End Point
security: []
paths:
/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/pre-provisional-scores/:
get:
parameters:
- in: path
name: examId
schema:
type: string
required: true
- name: ansSheetId
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
id:
type: string
description: Unique identifier of the exam
example: 4340132f-50fa-4877-9ffa-e9b7ee59d51f
examName:
type: string
description: Exam Name
example: CBSE 10 – Mock Test
subjectName:
type: string
description: Subject Name
example: Science
totalMarks:
type: number
description: Total marks of the exam
format: float
example: 80
obtainedMarks:
type: number
description: Marks obtained by the student
format: float
example: 45
questionMarkSumMismatch:
type: boolean
description: >-
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:
type: boolean
description: >-
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:
type: string
description: Duration of the exam
example: '180'
overallInstruction:
type: string
description: 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:
type: array
description: List of sections in the exam
items:
type: object
properties:
id:
type: string
description: Unique identifier of the section
example: ef66afc6-d923-43c6-b2d2-e29814306214
sectionName:
type: string
description: Name of the section
example: SECTION A
duration:
type: string
description: Duration of the section
example: null
instruction:
type: string
description: Instruction given for the section
example: null
totalMarks:
type: number
description: Total marks of the section
format: float
example: 20
obtainedMarks:
type: number
format: float
description: Marks obtained by the student
example: 13
parentQuestions:
type: array
description: List of parent questions in the section
items:
type: object
properties:
id:
type: string
description: Unique identifier of the parent question
example: fcb22595-c36a-4ddf-b9d3-00ba6d2ea466
text:
type: string
description: Text of the parent question
example: >-
Identify the option that indicates the correct
enzyme that is secreted in location i, ii and
iii.
marks:
type: integer
description: Marks of the parent question
example: 1
questionNumber:
type: string
description: Question number
example: Q1
questionType:
type: string
description: Type of the question
example: MCQ
questions:
type: array
items:
type: object
properties:
id:
type: string
example: 226986d3-95e4-4ed7-aaa4-3e7054f9bc5b
text:
type: string
example: >-
(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:
type: number
format: float
example: 1
isApproved:
type: boolean
example: false
questionNumber:
type: string
example: ''
diagramDescription:
type: string
example: null
supportingText:
type: string
example: MCQ
modelAnswer:
type: object
properties:
id:
type: string
example: 57837640-c695-44a5-9667-9cfb8bafebf1
answerText:
type: string
example: ''
stepMarking:
type: array
items:
type: object
properties:
marksplit:
type: number
example: 1
step_wise_answer:
type: string
example: >-
(b) (i) amylase, (ii) pepsin, (iii)
trypsin
answer:
type: array
items:
type: object
properties:
id:
type: string
example: f819bfd2-8aaa-42df-bd18-23cb989b2d16
answerText:
type: string
example: >-
(b) (i) amylase , (ii) pepsin, (iii)
Trypsin
marks:
type: number
format: float
example: 1
isApproved:
type: boolean
example: false
diagramDescription:
type: string
example: null
aiFeedbacks:
type: array
items:
type: object
properties:
feedback:
type: string
example: >-
The student has provided the correct
answer, demonstrating a clear
understanding of the enzymes associated
with the specified locations. Great job!
student_text:
type: string
example: >-
(b) (i) amylase , (ii) pepsin, (iii)
Trypsin
justification:
type: string
example: >-
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:
type: string
example: '0'
room_for_improvement:
type: string
example: >-
None, as the answer is correct and
complete.
teacherFeedback:
type: string
example: >-
The student has provided the correct
answer, demonstrating a clear
understanding of the enzymes associated
with the specified locations. Great job!
example:
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!
'400':
description: Bad Request
content:
application/json:
schema:
type: object
properties:
'error:':
type: object
properties:
code:
type: integer
example: 400
message:
type: object
properties:
non_field_errors:
type: array
items:
type: string
example: Answer Sheet is not evaluated yet!
'403':
description: Authentication failed.
content:
application/json:
schema:
type: object
properties:
detail:
type: string
example: Token has expired
example:
detail: Token has expired
'404':
description: Bad Request
content:
application/json:
schema:
type: object
properties:
'error:':
type: object
properties:
code:
type: integer
example: 400
message:
type: object
properties:
non_field_errors:
type: array
items:
type: string
example: Answer Sheet not found
security:
- bearerAuth: []
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
````