> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-management/online-programs/quiz-submissions/introduction.md

## Article Content:

# About the Quiz Submissions API

The Quiz Submissions API lets you manage quiz attempts within Online Programs. Use it to build custom participant experiences or display results from an existing program experience.

With the Quiz Submissions API, you can:

- Submit answers and evaluate a quiz attempt.
- Display stored answers, feedback, and evaluation results.
- Remove unwanted attempts.

## Quiz evaluation and program progress

A submission contains answers to a quiz and their stored evaluation results. Quiz settings determine the passing grade and attempt limit. Use `evaluationStatus` to read the result. Without a passing grade, the evaluation is completed without an earned grade.

Quiz evaluation and program-step completion are separate operations. Use Resolved Steps to associate a submission with participant progress. Deleting a submission doesn't directly undo a resolved step. Resolved-step changes can remove linked or older submissions, so submissions aren't a permanent archive of every attempt.

For answer formats, grouping attempts, grading, access behavior, and submission history, see [Quiz Submission Behavior](https://dev.wix.com/docs/api-reference/business-management/online-programs/quiz-submissions/quiz-submission-behavior.md).

## Related APIs

- Quiz defines the questions, answer options, passing grade, and attempt limit used to evaluate submissions.
- Steps identifies the quiz associated with a program step.
- Resolved Steps associates a submission with participant progress.
- Forms provides the backing form and stores submitted answer values. Use Quiz Submissions to submit quiz answers and retrieve their evaluation results.

## Before you begin

It's important to note the following points before starting to code:

- Identify the quiz and the participant's program step on the same site. Read the quiz definition to obtain question targets and answer options.
- Use the participant's signed-in [member identity](https://dev.wix.com/docs/overview/auth-permissions/identities.md) to create their submission. For headless clients, follow [member authentication](https://dev.wix.com/docs/go-headless/authentication/about-authentication.md#member-authentication) and use the member's access token or authenticated SDK client. App authentication doesn't impersonate a participant, and a participant ID isn't a site-member ID.
- Get and Delete check access separately. Callers with site-wide access can work with other submitters' submissions; site members with own-only access can work only with their own. See [Access to stored submissions](https://dev.wix.com/docs/api-reference/business-management/online-programs/quiz-submissions/quiz-submission-behavior.md#access-to-stored-submissions).
- Key answers by question target, not question field ID. Keep quiz, submission, and resolved-step IDs distinct.
- Retain the submission ID returned by creation. There is no public operation in this surface to list every attempt or update answers. Don't assume retrying Create after a timeout is idempotent.

## Use cases

- [Submit answers and display the result](https://dev.wix.com/docs/api-reference/business-management/online-programs/quiz-submissions/sample-flows.md#submit-answers-and-display-the-result).
- [Retrieve a saved result](https://dev.wix.com/docs/api-reference/business-management/online-programs/quiz-submissions/sample-flows.md#retrieve-a-saved-result).
- [Remove an unwanted attempt](https://dev.wix.com/docs/api-reference/business-management/online-programs/quiz-submissions/sample-flows.md#remove-an-unwanted-attempt).

## Terminology

- Quiz submission: One submitted set of answers and its stored evaluation results.
- Question target: The string used as an answer-map key, distinct from the question's field ID.
- Attempt group: A caller-specified `groupId` used to count attempts across quizzes for the same submitter.
- Resolved step: A participant's recorded result for a program step, separate from the quiz submission.

@sdk_package_setup