Enrolled Students

​

Authentication

​

Response

​

Response Example

{
  "success": true,
  "enrolledStudents": [
    {
      "student": {
        "_id": "user_2a1b3c4d5e6f",
        "name": "John Smith",
        "imageUrl": "https://example.com/avatars/john-smith.jpg"
      },
      "courseTitle": "Complete React Development Course",
      "purchaseDate": "2024-03-15T14:32:18.000Z"
    },
    {
      "student": {
        "_id": "user_9z8y7x6w5v4u",
        "name": "Jane Doe",
        "imageUrl": "https://example.com/avatars/jane-doe.jpg"
      },
      "courseTitle": "Complete React Development Course",
      "purchaseDate": "2024-03-16T09:15:42.000Z"
    },
    {
      "student": {
        "_id": "user_2a1b3c4d5e6f",
        "name": "John Smith",
        "imageUrl": "https://example.com/avatars/john-smith.jpg"
      },
      "courseTitle": "Advanced Node.js Course",
      "purchaseDate": "2024-03-18T11:20:33.000Z"
    },
    {
      "student": {
        "_id": "user_3b2c1d0e9f8g",
        "name": "Bob Wilson",
        "imageUrl": "https://example.com/avatars/bob-wilson.jpg"
      },
      "courseTitle": "TypeScript Masterclass",
      "purchaseDate": "2024-03-20T16:45:12.000Z"
    }
  ]
}

​

Data Collection Process

1. Fetch Educator Courses: Retrieves all courses created by the authenticated educator
2. Extract Course IDs: Creates an array of course IDs for purchase lookup
3. Query Purchases:
   • Finds all purchases matching the educator’s course IDs
   • Filters for only completed purchases
   • Populates student information (name and imageUrl)
   • Populates course information (courseTitle)
4. Transform Data: Maps purchase records to enrollment objects containing:
   • Student details
   • Course title
   • Purchase date (from createdAt field)

​

Key Differences from Dashboard Endpoint

• Purchase timestamps: Exact date and time of each enrollment
• Individual purchase records: Each purchase is a separate entry
• Complete purchase history: All completed transactions, not just enrolled students
• Chronological data: Useful for tracking enrollment trends over time

​

Use Cases

• Display detailed student enrollment tables
• Track enrollment trends and purchase history
• Generate reports on course purchases
• Show recent student enrollments
• Export enrollment data for analysis
• Identify popular courses by purchase frequency

​

Filtering and Sorting

// Client-side filtering by course
const reactCourseStudents = enrolledStudents.filter(
  enrollment => enrollment.courseTitle === "Complete React Development Course"
);

// Sort by most recent purchases
const recentEnrollments = enrolledStudents.sort(
  (a, b) => new Date(b.purchaseDate) - new Date(a.purchaseDate)
);

// Group by course
const groupedByCourse = enrolledStudents.reduce((acc, enrollment) => {
  const course = enrollment.courseTitle;
  if (!acc[course]) acc[course] = [];
  acc[course].push(enrollment);
  return acc;
}, {});

​

Error Response

{
  "success": false,
  "message": "An unexpected error occurred"
}

​

Notes

• Only completed purchases are included (pending or failed purchases are excluded)
• Students who purchased multiple courses will have multiple entries
• The purchaseDate field uses the createdAt timestamp from the Purchase model
• Student information is populated from the User collection via the userId reference
• Course information is populated from the Course collection via the courseId reference

​

Performance Considerations

• Uses MongoDB population to efficiently join related collections
• Filters at the database level for optimal performance
• Returns only necessary student fields (name, imageUrl) to reduce payload size