Get Enrolled Courses

Retrieve list of courses the authenticated user is enrolled in with course details and user ratings

GET /api/user/enrolled-courses

Get Enrolled Courses

cURL

curl --request GET \
  --url https://api.example.com/api/user/enrolled-courses

Success Response

{
  "success": true,
  "enrolledCourses": [
    {
      "_id": "60d5ec49f1b2c72b8c8e4f1a",
      "title": "Complete Web Development Bootcamp",
      "thumbnail": "https://res.cloudinary.com/skillrise/image/upload/v1234567890/courses/web-dev.jpg",
      "price": 49.99,
      "educator": {
        "_id": "educator_123abc",
        "name": "Jane Smith",
        "imageUrl": "https://..."
      },
      "totalLectures": 120,
      "totalDurationMinutes": 1800,
      "userRating": 5
    },
    {
      "_id": "60d5ec49f1b2c72b8c8e4f1b",
      "title": "Python for Data Science",
      "thumbnail": "https://res.cloudinary.com/skillrise/image/upload/v1234567890/courses/python-ds.jpg",
      "price": 39.99,
      "educator": {
        "_id": "educator_456def",
        "name": "Bob Johnson",
        "imageUrl": "https://..."
      },
      "totalLectures": 80,
      "totalDurationMinutes": 1200,
      "userRating": null
    }
  ]
}

Authentication

This endpoint requires authentication via Clerk. The userId is automatically extracted from the authentication token.

Response

success · boolean · required

Indicates whether the request was successful

enrolledCourses · array

Array of enrolled course objects

Show course properties

_id · string

Course unique identifier

title · string

Course title

thumbnail · string

URL to course thumbnail image

price · number

Course price

educator · object

Course educator information (populated from educatorId)

totalLectures · number

Total number of lectures in the course

totalDurationMinutes · number

Total duration of the course in minutes

userRating · number | null

User’s rating for this course (1-5) or null if not rated

message · string

Error message if success is false

Response Examples

Success Response

{
  "success": true,
  "enrolledCourses": [
    {
      "_id": "60d5ec49f1b2c72b8c8e4f1a",
      "title": "Complete Web Development Bootcamp",
      "thumbnail": "https://res.cloudinary.com/skillrise/image/upload/v1234567890/courses/web-dev.jpg",
      "price": 49.99,
      "educator": {
        "_id": "educator_123abc",
        "name": "Jane Smith",
        "imageUrl": "https://..."
      },
      "totalLectures": 120,
      "totalDurationMinutes": 1800,
      "userRating": 5
    },
    {
      "_id": "60d5ec49f1b2c72b8c8e4f1b",
      "title": "Python for Data Science",
      "thumbnail": "https://res.cloudinary.com/skillrise/image/upload/v1234567890/courses/python-ds.jpg",
      "price": 39.99,
      "educator": {
        "_id": "educator_456def",
        "name": "Bob Johnson",
        "imageUrl": "https://..."
      },
      "totalLectures": 80,
      "totalDurationMinutes": 1200,
      "userRating": null
    }
  ]
}

User Not Found

{
  "success": false,
  "message": "User not found"
}

Error Response

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

Error Codes

Status Code	Description
200	Success
401	Unauthorized - Invalid or missing authentication token
404	User not found
500	Internal server error

Notes

• The enrolledStudents field is excluded from course data in the response
• User ratings are retrieved from the courseRatings array within each course
• Courses are populated with full course details using MongoDB populate