AI Primary
GET /classes/{classId}/lessons
Bearer auth

Retrieves lessons for a class with optional filters.

Path parameters

  • classId string Required

    The class ID

Query parameters

  • teacherId string

    Filter by teacher ID

  • subject string

    Filter by subject

  • status string

    Filter by status

    Values are draft, planning, in-progress, completed, or archived.

  • page integer

    Page number

    Minimum value is 1. Default value is 1.

  • pageSize integer

    Page size

    Minimum value is 1, maximum value is 100.

Responses

  • 200 application/json

    Lessons retrieved successfully

    Hide response attributes Show response attributes object
    • success boolean
    • code integer(int32)
    • message string
    • data array[object]

      Lesson plan object representing a detailed plan for teaching or assignment

      Hide data attributes Show data attributes object
      • id string Required

        Unique identifier for the lesson

      • classId string Required

        ID of the class

      • authorId string Required

        ID of the teacher/author

      • title string Required

        Title of the lesson

        Maximum length is 200.

      • subject string | null

        Subject code (e.g., Math-1)

      • content string Required

        Lesson content or instructions

      • type string

        Type of lesson

        Values are assignment, material, lecture, or quiz.

      • status string

        Status of the lesson

        Values are draft, published, or archived.

      • learningObjectives array[object] | null

        Array of learning objectives

        Hide learningObjectives attributes Show learningObjectives attributes object
        • description string
        • type string
        • isAchieved boolean
        • notes string | null
      • lessonPlan string | null

        Private teacher notes/plan (not visible to students)

      • maxPoints integer | null

        Maximum points for assignments

      • dueDate string(date-time) | null

        Due date for assignments

      • createdAt string(date-time)

        Timestamp when the lesson was created

      • updatedAt string(date-time)

        Timestamp when the lesson was last updated

    • pagination object
      Hide pagination attributes Show pagination attributes object
      • currentPage

        The current page number (1-based indexing)

      • pageSize

        Number of items per page

      • totalItems

        Total number of items across all pages

      • totalPages

        Total number of available pages
  • 404 application/json

    Class not found

    Hide response attributes Show response attributes object
    • success boolean
    • code integer
    • errorCode string
    • message string
    • timestamp string(date-time)
  • 500 application/json

    Internal Server Error

    Hide response attributes Show response attributes object
    • success boolean
    • code integer
    • errorCode string
    • message string
    • timestamp string(date-time)
GET /classes/{classId}/lessons 
curl \
 --request GET 'http://localhost:8080/api/classes/{classId}/lessons' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "success": true,
  "code": 200,
  "message": "string",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440005",
      "classId": "550e8400-e29b-41d4-a716-446655440000",
      "authorId": "550e8400-e29b-41d4-a716-446655440001",
      "title": "Quadratic Equations",
      "subject": "MATH101",
      "content": "Students will learn to solve quadratic equations...",
      "type": "lecture",
      "status": "published",
      "learningObjectives": [
        {
          "description": "Students will be able to solve quadratic equations",
          "type": "knowledge",
          "isAchieved": false,
          "notes": "string"
        }
      ],
      "lessonPlan": "Start with examples, then practice problems",
      "maxPoints": 100,
      "dueDate": "2024-09-30T23:59:59Z",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-09-20T14:45:00Z"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 10,
    "totalItems": 100,
    "totalPages": 10
  }
}
Response examples (404) 
{
  "success": false,
  "code": 42,
  "errorCode": "string",
  "message": "string",
  "timestamp": "2026-05-04T09:42:00Z"
}
Response examples (500) 
{
  "success": false,
  "code": 42,
  "errorCode": "string",
  "message": "string",
  "timestamp": "2026-05-04T09:42:00Z"
}