Add Course Rating

curl --request POST \
  --url https://api.example.com/api/user/add-rating \
  --header 'Content-Type: application/json' \
  --data '
{
  "courseId": "<string>",
  "rating": 123,
  "review": "<string>"
}
'

import requests

url = "https://api.example.com/api/user/add-rating"

payload = {
    "courseId": "<string>",
    "rating": 123,
    "review": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({courseId: '<string>', rating: 123, review: '<string>'})
};

fetch('https://api.example.com/api/user/add-rating', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/user/add-rating",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'courseId' => '<string>',
    'rating' => 123,
    'review' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/user/add-rating"

	payload := strings.NewReader("{\n  \"courseId\": \"<string>\",\n  \"rating\": 123,\n  \"review\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/api/user/add-rating")
  .header("Content-Type", "application/json")
  .body("{\n  \"courseId\": \"<string>\",\n  \"rating\": 123,\n  \"review\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/user/add-rating")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"courseId\": \"<string>\",\n  \"rating\": 123,\n  \"review\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "data": {
    "courseId": "<string>",
    "rating": 123,
    "review": "<string>",
    "averageRating": 123,
    "totalRatings": 123
  }
}

POST

api

user

add-rating

Add Course Rating

curl --request POST \
  --url https://api.example.com/api/user/add-rating \
  --header 'Content-Type: application/json' \
  --data '
{
  "courseId": "<string>",
  "rating": 123,
  "review": "<string>"
}
'

import requests

url = "https://api.example.com/api/user/add-rating"

payload = {
    "courseId": "<string>",
    "rating": 123,
    "review": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({courseId: '<string>', rating: 123, review: '<string>'})
};

fetch('https://api.example.com/api/user/add-rating', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/user/add-rating",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'courseId' => '<string>',
    'rating' => 123,
    'review' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/user/add-rating"

	payload := strings.NewReader("{\n  \"courseId\": \"<string>\",\n  \"rating\": 123,\n  \"review\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/api/user/add-rating")
  .header("Content-Type", "application/json")
  .body("{\n  \"courseId\": \"<string>\",\n  \"rating\": 123,\n  \"review\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/user/add-rating")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"courseId\": \"<string>\",\n  \"rating\": 123,\n  \"review\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "data": {
    "courseId": "<string>",
    "rating": 123,
    "review": "<string>",
    "averageRating": 123,
    "totalRatings": 123
  }
}

Overview

Allows students to rate a course they have completed. Ratings are stored with the user’s enrollment record and displayed on course detail pages.

Authentication

Requires Clerk authentication. The user must be enrolled in the course.

Request Body

string

required

The MongoDB ObjectId of the course to rate

number

required

Rating value between 1-5 starsMust be an integer: 1, 2, 3, 4, or 5

string

Optional text review/comment about the courseMaximum length: 500 characters

Response

boolean

Indicates whether the rating was saved successfully

string

Confirmation message

object

The updated course rating information

Show data

string

The course that was rated

number

The submitted rating (1-5)

string

The submitted review text

number

Updated average rating for the course

number

Total number of ratings the course has received

Request Example

{
  "courseId": "65f3a1b2c3d4e5f6g7h8i9j0",
  "rating": 5,
  "review": "Excellent course! The instructor explained complex concepts clearly and the hands-on projects were very helpful."
}

Response Example

{
  "success": true,
  "message": "Rating submitted successfully",
  "data": {
    "courseId": "65f3a1b2c3d4e5f6g7h8i9j0",
    "rating": 5,
    "review": "Excellent course! The instructor explained...",
    "averageRating": 4.7,
    "totalRatings": 128
  }
}

Error Responses

Missing required fields
Invalid rating value (not 1-5)
Review text exceeds 500 characters

User is not enrolled in the course
Course does not exist

User has not completed the course yet
Ratings may be restricted to completed courses only

Implementation Details

Rating Storage

Ratings are stored in the User model’s courseRatings array:

courseRatings: [
  {
    courseId: ObjectId,
    rating: Number,      // 1-5
    review: String,
    createdAt: Date
  }
]

Rating Update Rules

Users can update their rating for a course by submitting again
The most recent rating replaces any previous rating
Average rating is recalculated for the course after each submission

Code Examples

const response = await fetch(`${BACKEND_URL}/api/user/add-rating`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${clerkToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    courseId: '65f3a1b2c3d4e5f6g7h8i9j0',
    rating: 5,
    review: 'Great course with excellent content!'
  })
});

const data = await response.json();
console.log(`Average rating: ${data.data.averageRating}`);

curl -X POST "https://api.skillrise.com/api/user/add-rating" \
  -H "Authorization: Bearer YOUR_CLERK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "courseId": "65f3a1b2c3d4e5f6g7h8i9j0",
    "rating": 5,
    "review": "Excellent course with clear explanations!"
  }'

import requests

response = requests.post(
    f"{BACKEND_URL}/api/user/add-rating",
    headers={
        "Authorization": f"Bearer {clerk_token}",
        "Content-Type": "application/json"
    },
    json={
        "courseId": "65f3a1b2c3d4e5f6g7h8i9j0",
        "rating": 5,
        "review": "Great learning experience!"
    }
)

data = response.json()
print(f"Course now has {data['data']['totalRatings']} ratings")

Use Cases

Collect student feedback on course quality
Display ratings on course pages to help prospective students
Calculate average ratings to rank courses
Identify top-rated courses for marketing purposes

Get Course - View course with ratings
Get Enrolled Courses - See which courses you can rate

Overview

Course API

User API

AI Features API

Quiz API

Community API

Educator API

Admin API

Webhooks

Add Course Rating

Overview

Authentication

Request Body

Response

Request Example

Response Example

Error Responses

Implementation Details

Rating Storage

Rating Update Rules

Code Examples

Use Cases

​Overview

​Authentication

​Request Body

​Response

​Request Example

​Response Example

​Error Responses

​Implementation Details

​Rating Storage

​Rating Update Rules

​Code Examples

​Use Cases

​Related Endpoints

Overview

Authentication

Request Body

Response

Request Example

Response Example

Error Responses

Implementation Details

Rating Storage

Rating Update Rules

Code Examples

Use Cases

Related Endpoints