GET /api/v1/student/{studentId}/assessments/upcoming

Retrieve all upcoming assessments (assignments, CATs, exams) for the student within the next 30 days, sorted by due date

Path parameters

  • studentId string Required

    Unique identifier of the student

Responses

  • 200 application/json

    Upcoming assessments retrieved successfully

    Hide response attributes Show response attributes object
    • message string Required

      Success message

    • success boolean Required

      Success status

    • assessments array[object] Required

      Upcoming assessments

      Hide assessments attributes Show assessments attributes object
      • id string Required

        Assessment ID

      • title string Required

        Assessment title

      • type string Required

        Assessment type

        Values are assignment, cat, or exam.

      • unitCode string Required

        Unit code

      • unitTitle string Required

        Unit title

      • dueDate string Required

        Due date

      • daysRemaining number Required

        Days remaining

      • totalMarks number Required

        Total marks

      • status string Required

        Status

  • 400 application/json

    Default bad request error 400 response

    Hide response attributes Show response attributes object
    • message string Required

      Response message

    • error string Required
    • statusCode number Required
  • 404

    Student not found

GET /api/v1/student/{studentId}/assessments/upcoming
curl \
 --request GET 'https://api.echoplain.social/api/v1/student/uuid-string/assessments/upcoming'
Response examples (200)
{
  "message": "string",
  "success": true,
  "assessments": [
    {
      "id": "uuid-string",
      "title": "Programming Assignment 1",
      "type": "assignment",
      "unitCode": "CS201",
      "unitTitle": "Data Structures and Algorithms",
      "dueDate": "2025-10-15T23:59:59.000Z",
      "daysRemaining": 5,
      "totalMarks": 15,
      "status": "string"
    }
  ]
}
Response examples (400)
{
  "message": "string",
  "error": "string",
  "statusCode": 42.0
}