Quiz Submission Object


Answers submitted to a quiz within an Online Program, together with their evaluation results.

Properties
answersMap <string, Answer>format map

Answers keyed by each quiz question's target, not its field ID. Each response answer includes the corresponding fieldId. An unrecognized target causes submission creation to fail.


createdDatestringRead-onlyformat date-time

Date and time the quiz submission was created.


earnedGradeintegerRead-onlyformat int32

Integer percentage of submitted answers evaluated as correct, rounded down. Non-evaluable answers count as correct, including answers to questions without a stored correct-answer key. Question scores are not used as weights. Omitted when the quiz has no passing grade.


evaluationStatusstringRead-only

Stored evaluation result. An unspecified value must not be treated as failure or completion.


extendedFieldsExtendedFields

Custom field data for the quiz submission. Extended fields must be configured in the app dashboard before they can be accessed with API calls. Set extendedFields when creating a submission; Create, Get, and Delete return the stored values, subject to Data Extensions schema and access permissions.


groupIdstringformat GUID

Groups attempts for the same submitter when enforcing the quiz's attempt limit. If omitted, attempts are counted by quizId and submitter, and groupId remains absent in the response. If provided, counting uses groupId and submitter without restricting by quizId.


idstringRead-onlyformat GUID

Quiz submission ID.


passingGradeintegerRead-onlyformat int32

Passing-grade threshold copied from the quiz settings when the submission is created. Compared with earnedGrade on the same percentage scale. Omitted if the quiz has no passing grade; later quiz-setting changes do not recalculate this submission.


quizIdstringformat GUID

Quiz ID.


revisionstringRead-onlyformat int64

Revision number of the backing form submission. Increases when that submission is updated.


updatedDatestringRead-onlyformat date-time

Date and time the quiz submission was last updated.

Did this help?