List Courses

Retrieve a list of all published courses

GET /api/course/all

List Courses

cURL

curl --request GET \
  --url https://api.example.com/api/course/all

Success (200)

{
  "success": true,
  "courses": [
    {
      "_id": "65f8a2b3c4d5e6f7a8b9c0d1",
      "courseTitle": "Complete Web Development Bootcamp",
      "courseDescription": "Learn web development from scratch with HTML, CSS, JavaScript, React, Node.js and more",
      "courseThumbnail": "https://example.com/thumbnails/web-dev-bootcamp.jpg",
      "coursePrice": 49.99,
      "isPublished": true,
      "discount": 20,
      "averageRating": 4.7,
      "totalRatings": 342,
      "totalLectures": 156,
      "totalDurationMinutes": 1840,
      "educatorId": {
        "_id": "65f8a1b2c3d4e5f6a7b8c9d0",
        "name": "John Smith",
        "imageUrl": "https://example.com/profiles/john-smith.jpg"
      },
      "totalEnrolledStudents": 1523,
      "createdAt": "2024-03-15T10:30:00.000Z",
      "updatedAt": "2024-03-20T14:22:00.000Z"
    },
    {
      "_id": "65f8a2b3c4d5e6f7a8b9c0d2",
      "courseTitle": "Data Science with Python",
      "courseDescription": "Master data analysis, visualization, and machine learning with Python",
      "courseThumbnail": "https://example.com/thumbnails/data-science.jpg",
      "coursePrice": 79.99,
      "isPublished": true,
      "discount": 0,
      "averageRating": 4.9,
      "totalRatings": 587,
      "totalLectures": 203,
      "totalDurationMinutes": 2650,
      "educatorId": {
        "_id": "65f8a1b2c3d4e5f6a7b8c9d1",
        "name": "Sarah Johnson",
        "imageUrl": "https://example.com/profiles/sarah-johnson.jpg"
      },
      "totalEnrolledStudents": 2341,
      "createdAt": "2024-03-10T08:15:00.000Z",
      "updatedAt": "2024-03-18T16:45:00.000Z"
    }
  ]
}

Endpoint

GET /api/course/all

Authentication

No authentication required. This is a public endpoint.

Query Parameters

This endpoint does not accept any query parameters.

Response

success · boolean · required

Indicates whether the request was successful

courses · array · required

Array of published course objects

Show Course Object

_id · string · required

Unique identifier for the course

courseTitle · string · required

Title of the course

courseDescription · string · required

Detailed description of the course

courseThumbnail · string

URL to the course thumbnail image

coursePrice · number · required

Price of the course in the platform’s currency

isPublished · boolean · required

Publication status (always true for this endpoint)

discount · number · required

Discount percentage applied to the course (0-100)

averageRating · number

Average rating of the course (0-5)

totalRatings · number

Total number of ratings received

totalLectures · number

Total number of lectures in the course

totalDurationMinutes · number

Total duration of the course in minutes

educatorId · object · required

Educator information (populated)

Show Educator Object

_id · string

Unique identifier for the educator

name · string

Name of the educator

imageUrl · string

URL to the educator’s profile image

totalEnrolledStudents · number

Total number of students enrolled in the course

createdAt · string

ISO 8601 timestamp of when the course was created

updatedAt · string

ISO 8601 timestamp of when the course was last updated

Success Response

Success (200)

{
  "success": true,
  "courses": [
    {
      "_id": "65f8a2b3c4d5e6f7a8b9c0d1",
      "courseTitle": "Complete Web Development Bootcamp",
      "courseDescription": "Learn web development from scratch with HTML, CSS, JavaScript, React, Node.js and more",
      "courseThumbnail": "https://example.com/thumbnails/web-dev-bootcamp.jpg",
      "coursePrice": 49.99,
      "isPublished": true,
      "discount": 20,
      "averageRating": 4.7,
      "totalRatings": 342,
      "totalLectures": 156,
      "totalDurationMinutes": 1840,
      "educatorId": {
        "_id": "65f8a1b2c3d4e5f6a7b8c9d0",
        "name": "John Smith",
        "imageUrl": "https://example.com/profiles/john-smith.jpg"
      },
      "totalEnrolledStudents": 1523,
      "createdAt": "2024-03-15T10:30:00.000Z",
      "updatedAt": "2024-03-20T14:22:00.000Z"
    },
    {
      "_id": "65f8a2b3c4d5e6f7a8b9c0d2",
      "courseTitle": "Data Science with Python",
      "courseDescription": "Master data analysis, visualization, and machine learning with Python",
      "courseThumbnail": "https://example.com/thumbnails/data-science.jpg",
      "coursePrice": 79.99,
      "isPublished": true,
      "discount": 0,
      "averageRating": 4.9,
      "totalRatings": 587,
      "totalLectures": 203,
      "totalDurationMinutes": 2650,
      "educatorId": {
        "_id": "65f8a1b2c3d4e5f6a7b8c9d1",
        "name": "Sarah Johnson",
        "imageUrl": "https://example.com/profiles/sarah-johnson.jpg"
      },
      "totalEnrolledStudents": 2341,
      "createdAt": "2024-03-10T08:15:00.000Z",
      "updatedAt": "2024-03-18T16:45:00.000Z"
    }
  ]
}

Error Response

Server Error (500)

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

Error Codes

500 · Internal Server Error

An unexpected error occurred while fetching courses. This typically indicates a database connection issue or server error.

Implementation Notes

• This endpoint only returns courses where isPublished is true
• The following fields are excluded from the response for performance:
  • courseContent (chapter and lecture details)
  • courseRatings (individual user ratings)
  • enrolledStudents (list of enrolled student IDs)
• The educatorId field is populated with basic educator information (name and image)
• Courses are returned in the order they are stored in the database

Code Examples

JavaScript (Fetch)

const response = await fetch('https://api.skillrise.com/api/course/all');
const data = await response.json();

if (data.success) {
  console.log(`Found ${data.courses.length} courses`);
  data.courses.forEach(course => {
    console.log(`${course.courseTitle} - $${course.coursePrice}`);
  });
} else {
  console.error('Failed to fetch courses:', data.message);
}

Use Cases

Display Course Catalog

const displayCourseCatalog = async () => {
  const response = await fetch('https://api.skillrise.com/api/course/all');
  const { success, courses } = await response.json();
  
  if (success) {
    return courses.map(course => ({
      id: course._id,
      title: course.courseTitle,
      instructor: course.educatorId.name,
      price: course.coursePrice * (1 - course.discount / 100), // Apply discount
      rating: course.averageRating,
      students: course.totalEnrolledStudents,
      duration: `${Math.floor(course.totalDurationMinutes / 60)}h ${course.totalDurationMinutes % 60}m`
    }));
  }
};

Filter and Search Courses

const searchCourses = async (query) => {
  const response = await fetch('https://api.skillrise.com/api/course/all');
  const { success, courses } = await response.json();
  
  if (success) {
    return courses.filter(course => 
      course.courseTitle.toLowerCase().includes(query.toLowerCase()) ||
      course.courseDescription.toLowerCase().includes(query.toLowerCase())
    );
  }
};