Submit Quiz Result

Submit quiz answers and receive score with AI-powered recommendations

POST /api/quiz/submit

Submit Quiz Result

cURL

curl --request POST \
  --url https://api.example.com/api/quiz/submit \
  --header 'Content-Type: application/json' \
  --data '
{
  "courseId": "<string>",
  "chapterId": "<string>",
  "answers": [
    {}
  ]
}
'

Invalid Request Data

{
  "success": false,
  "message": "Invalid request data"
}

Authentication

This endpoint requires user authentication. Include the authorization token in your request headers.

Authorization: Bearer <user_token>

Request Body

courseId · string · required

The unique identifier of the course

chapterId · string · required

The unique identifier of the chapter

answers · array · required

Array of answer indices (0-3) corresponding to each quiz question. Must match the number of questions in the quiz.

Example: [0, 2, 1, 3, 0, 1, 2, 0, 3, 1]

Response

success · boolean

Indicates whether the submission was successful

result · object

The quiz result with scoring and recommendations

Show result object

score · number

Number of correct answers

total · number

Total number of questions

percentage · number

Score as a percentage (rounded to nearest integer)

group · string

Performance category: "needs_review" (≤40%), "on_track" (41-75%), or "mastered" (>75%)

recommendations · string

AI-generated personalized recommendations to improve understanding. Contains 4-5 bullet points with actionable advice.

message · string

Error message if success is false

Code Examples

JavaScript

const response = await fetch('https://api.skillrise.com/api/quiz/submit', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  },
  body: JSON.stringify({
    courseId: '507f1f77bcf86cd799439011',
    chapterId: 'chapter-001',
    answers: [0, 2, 1, 3, 0, 1, 2, 0, 3, 1]
  })
});

const data = await response.json();
console.log(data.result);

Response Example

High Performance (Mastered)

{
  "success": true,
  "result": {
    "score": 9,
    "total": 10,
    "percentage": 90,
    "group": "mastered",
    "recommendations": "• Excellent work! You've demonstrated strong mastery of variables and data types\n• Challenge yourself by exploring advanced topics like type coercion and symbol data types\n• Practice building small projects that utilize different data types effectively\n• Consider helping peers who are struggling with these concepts to reinforce your knowledge\n• Keep up the great momentum as you progress through the course"
  }
}

Moderate Performance (On Track)

{
  "success": true,
  "result": {
    "score": 6,
    "total": 10,
    "percentage": 60,
    "group": "on_track",
    "recommendations": "• Review the differences between let, const, and var declarations\n• Practice writing code examples for each primitive data type\n• Revisit the lectures on type conversion and comparison operators\n• Try creating a small project that uses different variable types\n• Don't get discouraged - you're making solid progress!"
  }
}

Low Performance (Needs Review)

{
  "success": true,
  "result": {
    "score": 3,
    "total": 10,
    "percentage": 30,
    "group": "needs_review",
    "recommendations": "• Revisit all lectures in this chapter, taking detailed notes\n• Focus on understanding what variables are and how they store data\n• Practice declaring variables using let and const with simple examples\n• Watch supplementary videos on JavaScript data types\n• Consider scheduling time with a tutor or joining a study group\n• Remember that learning takes time - stay persistent!"
  }
}

Error Responses

Invalid Request Data

{
  "success": false,
  "message": "Invalid request data"
}

Quiz Not Found

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

Answer Count Mismatch

{
  "success": false,
  "message": "Answer count does not match question count"
}

Performance Groups

Group	Percentage Range	Description
needs_review	0-40%	Significant gaps in understanding. Comprehensive review recommended.
on_track	41-75%	Good progress with room for improvement. Additional practice suggested.
mastered	76-100%	Strong comprehension. Ready to advance to next topics.

Notes

• The quiz result is automatically saved to the database and associated with the user’s account
• AI recommendations are personalized based on:
  • The specific questions answered incorrectly
  • The overall performance level
  • The chapter content and topics covered
• Users can retake quizzes multiple times - all attempts are stored
• The answers array must contain exactly the same number of elements as there are questions in the quiz
• Each answer must be an integer from 0 to 3, corresponding to the option index