Submit complete quiz answers

POST

api/v1/user/{userKey}/quizzes/submit

Submit all answers for a quiz in a single form-like submission with automatic scoring, validation, and reward processing.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://api-stg.98s.studio/api/v1/user/{{user-key}}/quizzes/submit' \
--header 'x-api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "quizId": "877aae38-1c65-4da4-bcc1-3e015ee7aaa4",
  "answers": [
    {
      "questionId": "dc02947b-7d85-4d55-92d4-0482d6564a34",
      "answer": "0"
    },
      {
      "questionId": "c6cc7ba6-1022-4d18-aa2c-a320e9b29b36",
      "answer": "1"
    }
  ]
}'

Response Example

{
    "id": "fe4d8c91-97f2-48cc-9158-a27673331048",
    "quizId": "877aae38-1c65-4da4-bcc1-3e015ee7aaa4",
    "quizName": "MATH 254",
    "userKey": "1765132434113",
    "status": 2,
    "score": 100,
    "correctAnswers": 2,
    "totalQuestions": 2,
    "scorePercentage": 100,
    "completedAt": "2026-01-03T19:52:21.9871449Z",
    "answers": [
        {
            "id": "5491834c-0d92-44f6-9caa-b0bf31f69d9f",
            "questionId": "dc02947b-7d85-4d55-92d4-0482d6564a34",
            "question": "1 + 1",
            "userAnswer": "0",
            "isCorrect": true
        },
        {
            "id": "3a2f834e-cb1a-4fe4-befb-49f1b61aef49",
            "questionId": "c6cc7ba6-1022-4d18-aa2c-a320e9b29b36",
            "question": "2 x 2",
            "userAnswer": "1",
            "isCorrect": true
        }
    ],
    "hasReward": true,
    "rewardType": "Point",
    "rewardAmount": 20
}

Modified at 2026-01-03 19:58:48

Get available quizzes for user

Get comprehensive user quiz history