Get Upcoming Classes

​

GET /api/upcoming-classes

​

Authentication

​

Query Parameters

​

Response

​

Example Request

curl -X GET https://your-domain.com/api/upcoming-classes

​

Example Response

{
  "response": [
    {
      "id": "65f8a3b2c1d4e5f6a7b8c9d0",
      "maxParticipants": 5,
      "classType": "grupal",
      "status": "scheduled",
      "startTime": "2026-03-15T10:00:00.000Z",
      "endTime": "2026-03-15T11:00:00.000Z"
    },
    {
      "id": "65f8a3b2c1d4e5f6a7b8c9d1",
      "maxParticipants": 1,
      "classType": "individual",
      "status": "scheduled",
      "startTime": "2026-03-15T14:00:00.000Z",
      "endTime": "2026-03-15T15:00:00.000Z"
    },
    {
      "id": "65f8a3b2c1d4e5f6a7b8c9d2",
      "maxParticipants": 3,
      "classType": "grupal",
      "status": "pending",
      "startTime": "2026-03-16T09:00:00.000Z",
      "endTime": "2026-03-16T10:30:00.000Z"
    }
  ]
}

​

Filtering Logic

• startTime is greater than or equal to the current date/time
• Results are ordered by startTime in ascending order (earliest first)

​

Use Cases

• Display available upcoming classes on a public calendar
• Show students what classes are available to join
• Allow administrators to view the schedule of future classes
• Enable users to browse classes by type and availability

​

Notes

• The response includes classes with any status (scheduled, pending, etc.)
• Past classes (where startTime is before the current time) are automatically filtered out
• The response may be empty if no upcoming classes are scheduled
• Class capacity and current participant information can be used to determine if a class is full