List worksheets

GET

worksheet

listing

List worksheets

curl --request GET \
  --url https://api.crazygoldfish.com/worksheet/v1/listing \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.crazygoldfish.com/worksheet/v1/listing', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "pagination": {
    "page": 1,
    "page_size": 10,
    "total": 1,
    "total_pages": 1,
    "has_next": false,
    "has_previous": false
  },
  "data": [
    {
      "id": "152764ca-1685-427c-aba7-4b92dcc0d60f",
      "board": {
        "id": "baf36573-d049-4636-9c4b-bc9cda6270fe",
        "name": "CBSE"
      },
      "grade": {
        "id": "28820b1a-34e1-4003-b5bd-96455ca2c6d8",
        "name": "Grade 10"
      },
      "section": null,
      "subject": {
        "id": "6dd7ebda-1bc5-4c01-8649-372579189073",
        "name": "Science"
      },
      "status": "Completed",
      "number_of_questions": 5,
      "topic": "Magnetic Effects of Electric Current",
      "documents": [],
      "audio": null,
      "current_stage": "Question Generation",
      "meta_data": {
        "teacher_id": "T-1042"
      },
      "created_at": "2026-09-17T10:42:18.512000"
    }
  ]
}

The list only includes worksheets created with the same API user as your access token. Results are newest first.

Filter by your own fields

Any query parameter other than page and page_size filters on the meta_data you sent when starting the worksheet. For example, if you started worksheets with meta_data={"teacher_id": "T-1042"}:

curl "https://api.crazygoldfish.com/worksheet/v1/listing?teacher_id=T-1042" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

A parameter that doesn’t match a meta_data key returns an empty list, not an error.

Reading progress

current_stage is the latest step that has started, and status is that step’s status:

`current_stage`	Step
`Initialize Metadata`	Start a worksheet
`Question Configuration`	Configure worksheet questions
`Question Generation`	Generate worksheet questions
`Explanation Generation`	Generate worksheet explanations

Authorizations

Authorization

string

header

required

Access token from Get an access token.

Query Parameters

page

integer

default:1

Page number, starting at 1.

Required range: x >= 1

page_size

integer

default:10

Items per page. Maximum 100.

Required range: 1 <= x <= 100

Response

A page of worksheets.

pagination

object

Show child attributes

data

object[]

Show child attributes

List worksheets

curl --request GET \
  --url https://api.crazygoldfish.com/worksheet/v1/listing \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.crazygoldfish.com/worksheet/v1/listing', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "pagination": {
    "page": 1,
    "page_size": 10,
    "total": 1,
    "total_pages": 1,
    "has_next": false,
    "has_previous": false
  },
  "data": [
    {
      "id": "152764ca-1685-427c-aba7-4b92dcc0d60f",
      "board": {
        "id": "baf36573-d049-4636-9c4b-bc9cda6270fe",
        "name": "CBSE"
      },
      "grade": {
        "id": "28820b1a-34e1-4003-b5bd-96455ca2c6d8",
        "name": "Grade 10"
      },
      "section": null,
      "subject": {
        "id": "6dd7ebda-1bc5-4c01-8649-372579189073",
        "name": "Science"
      },
      "status": "Completed",
      "number_of_questions": 5,
      "topic": "Magnetic Effects of Electric Current",
      "documents": [],
      "audio": null,
      "current_stage": "Question Generation",
      "meta_data": {
        "teacher_id": "T-1042"
      },
      "created_at": "2026-09-17T10:42:18.512000"
    }
  ]
}

Get started

Guides

Exam Evaluation

Assignment Evaluation

Rubrics

Action Plans

Lesson Plan Builder

Worksheet Builder

ClassTrack

Metadata

Webhooks

Filter by your own fields

Reading progress

Authorizations

Query Parameters

Response

​Filter by your own fields

​Reading progress

Authorizations

Query Parameters

Response

Filter by your own fields

Reading progress