List lesson plans

GET

lesson-plan

listing

List lesson plans

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

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

fetch('https://api.crazygoldfish.com/lesson-plan/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": "7d2f1b90-4c6a-4f3e-b1d7-9a5e2c8f0b34",
      "board": {
        "id": "baf36573-d049-4636-9c4b-bc9cda6270fe",
        "name": "CBSE"
      },
      "grade": {
        "id": "28820b1a-34e1-4003-b5bd-96455ca2c6d8",
        "name": "Grade 10"
      },
      "section": "A",
      "subject": {
        "id": "6dd7ebda-1bc5-4c01-8649-372579189073",
        "name": "Science"
      },
      "topic": "Magnetic Effects of Electric Current",
      "duration_minutes": 45,
      "documents": [],
      "audio": null,
      "current_stage": "Instructional Framework Builder",
      "status": "Completed",
      "meta_data": {
        "teacher_id": "T-1042"
      },
      "created_at": "2026-09-17T10:42:18.512000"
    }
  ]
}

The list only includes lesson plans 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 lesson plan. For example, if you started lesson plans with meta_data={"teacher_id": "T-1042"}:

curl "https://api.crazygoldfish.com/lesson-plan/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 furthest step that has started, and status is that step’s status:

`current_stage`	Step
`Lesson Plan Initiated`	Start a lesson plan
`Finalize Metadata`	Finalize lesson plan metadata
`Instructional Framework Builder`	Build lesson plan content
`Additional Enrichment Block`	Add lesson plan enrichment blocks

current_stage is null until the first job creates its step, which is also when the lesson plan first appears with a step to report. Until then, status is the lesson plan’s own status, In Progress.

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 lesson plans.

pagination

object

Show child attributes

data

object[]

Show child attributes

List lesson plans

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

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

fetch('https://api.crazygoldfish.com/lesson-plan/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": "7d2f1b90-4c6a-4f3e-b1d7-9a5e2c8f0b34",
      "board": {
        "id": "baf36573-d049-4636-9c4b-bc9cda6270fe",
        "name": "CBSE"
      },
      "grade": {
        "id": "28820b1a-34e1-4003-b5bd-96455ca2c6d8",
        "name": "Grade 10"
      },
      "section": "A",
      "subject": {
        "id": "6dd7ebda-1bc5-4c01-8649-372579189073",
        "name": "Science"
      },
      "topic": "Magnetic Effects of Electric Current",
      "duration_minutes": 45,
      "documents": [],
      "audio": null,
      "current_stage": "Instructional Framework Builder",
      "status": "Completed",
      "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