AI Primary
GET /lessons/{lessonId}/submissions
Bearer auth

Retrieves all student submissions for an assignment lesson. Teachers can view all; students can only view their own.

Path parameters

  • lessonId string Required

    The lesson (assignment) ID

Query parameters

  • status string

    Filter by submission status

    Values are draft, submitted, returned, late, or graded.

  • page integer

    Page number (1-based)

    Minimum value is 1. Default value is 1.

  • pageSize integer

    Items per page

    Minimum value is 1, maximum value is 100. Default value is 10.

Responses

  • 200 application/json

    Submissions retrieved successfully

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

      Student submission for assignments

      Hide data attributes Show data attributes object
      • id string Required

        Unique identifier for the submission

      • lessonId string Required

        ID of the lesson/assignment

      • studentId string Required

        ID of the student

      • fileUrls array[string(uri)] | null

        Array of file URLs uploaded by student

      • grade integer | null

        Grade/points awarded

      • feedback string | null

        Teacher feedback on the submission

      • status string

        Submission status

        Values are draft, submitted, returned, late, or graded.

      • submittedAt string(date-time) | null

        Timestamp when submitted

      • returnedAt string(date-time) | null

        Timestamp when returned by teacher

      • createdAt string(date-time)

        Timestamp when submission record was created

      • updatedAt string(date-time)

        Timestamp when submission 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
  • 401 application/json

    Unauthorized - Invalid or missing authentication token

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

    Lesson 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 /lessons/{lessonId}/submissions 
curl \
 --request GET 'http://localhost:8080/api/lessons/{lessonId}/submissions' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "success": true,
  "code": 200,
  "message": "string",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440007",
      "lessonId": "550e8400-e29b-41d4-a716-446655440005",
      "studentId": "550e8400-e29b-41d4-a716-446655440002",
      "fileUrls": [
        "https://example.com/submission1.pdf"
      ],
      "grade": 85,
      "feedback": "Good work, but needs improvement on part 2",
      "status": "graded",
      "submittedAt": "2024-09-25T10:30:00Z",
      "returnedAt": "2024-09-27T14:00:00Z",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-09-27T14:00:00Z"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 10,
    "totalItems": 100,
    "totalPages": 10
  }
}
Response examples (401) 
{
  "success": false,
  "code": 42,
  "errorCode": "string",
  "message": "string",
  "timestamp": "2026-05-04T09:42:00Z"
}
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"
}