List exam answer sheets

GET

evaluation-platform

exam

{examId}

answer-sheet

List exam answer sheets

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

import requests

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

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/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": "8a2f4c1e-5b3d-4e6f-9a7b-0c1d2e3f4a5b",
      "documents": [
        {
          "id": "c6d1e0f9-3a52-4b87-9d64-5e1f2a3b4c5d",
          "status": 0,
          "pageNo": null,
          "uploadTime": "2026-03-18T09:14:02.481293Z",
          "url": "https://<storage-host>/media/evaluation/page-1.jpg",
          "fileType": 3
        }
      ],
      "studentId": "S-2043",
      "instituteId": "SCH-17",
      "teacherId": "T-1042",
      "studentName": "Aarav Sharma",
      "parentId": "P-9981"
    }
  ]
}

Use this call to find an answer sheet’s id, and to watch upload and evaluation progress for a whole class in one request.

Rules

Sheets come back newest first. This list is not paginated, so an exam with many students returns them all.
studentName matches part of a name, ignoring case. studentId, teacherId, instituteId, and parentId match exactly.
documents[].status shows each file’s progress: 0 Open, 1 In Progress, 2 Completed, 3 Failed.

An exam ID that does not exist returns 200 with an empty data array, not 404.

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. Write it in lowercase: this path only matches lowercase hexadecimal characters and hyphens.

Example:

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

Query Parameters

studentId

string

Keep sheets with exactly this studentId.

Example:

"S-2043"

instituteId

string

Keep sheets with exactly this instituteId.

teacherId

string

Keep sheets with exactly this teacherId.

studentName

string

Keep sheets whose studentName contains this text, ignoring case.

parentId

string

Keep sheets with exactly this parentId.

Response

The exam's answer sheets. data is empty when the exam has none, and when the exam ID does not exist.

data

object[]

Show child attributes

List exam answer sheets

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

import requests

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

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/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": "8a2f4c1e-5b3d-4e6f-9a7b-0c1d2e3f4a5b",
      "documents": [
        {
          "id": "c6d1e0f9-3a52-4b87-9d64-5e1f2a3b4c5d",
          "status": 0,
          "pageNo": null,
          "uploadTime": "2026-03-18T09:14:02.481293Z",
          "url": "https://<storage-host>/media/evaluation/page-1.jpg",
          "fileType": 3
        }
      ],
      "studentId": "S-2043",
      "instituteId": "SCH-17",
      "teacherId": "T-1042",
      "studentName": "Aarav Sharma",
      "parentId": "P-9981"
    }
  ]
}

Get started

Guides

Exam Evaluation

Assignment Evaluation

Rubrics

Action Plans

Lesson Plan Builder

Worksheet Builder

ClassTrack

Metadata

Webhooks

Rules

Authorizations

Path Parameters

Query Parameters

Response

​Rules

Authorizations

Path Parameters

Query Parameters

Response

Rules