( status field in the GET student_sessions/ responses)
| Status | Description |
|---|---|
| registered | Is set when the student gets added to an exam (i.e. when his student_session is created) |
| email_sent | Is set when the email is sent from our platform (happens when click on the send email from the platform or when we call POST /exams/:id/send_emails with the API).
Note: Also if emails are suppressed, i.e. not sent by Proctorexam, the status will be changed to email_sent when one of the above is triggered. |
| after_check_req | Is set when the student finishes the check_requirements |
| in_setup | Is set when the student enters the setup of his exam but hasn't started the exam yet |
| exam_not_started | Is set when the student enters the setup of his exam and leaves before he starts the exam |
| exam_started | Is set when the student enters the exam or more precisely when he clicks on the button "Start Exam" at the end of the setup. This is when the student instructions are shown and the timer for the exam starts running (if enabled) |
| exam_finished | Is set when the student clicks on the button "Finish Exam" on the exam page, the live proctor ends the exam, the exam is ended by the /end_exam API call or the exam session times out: The platform automatically considers the exam ended if recordings have stopped for at least 3 hours or if the exam was started at least 9 hours ago. |
( status field in the GET exams/ responses)
| Status | Description |
|---|---|
| draft | Is set when exam creation is started |
| open | Is set when documents are added to the exam (student instructions) |
| closed | Is set when someone closes an exam or the last start time elapses |
( microphone_check, speakers_check, bandwidth_check,
webcam_check, mobile_check, screenshare_check fields in the GET student_sessions/ responses)
| Status | Description |
|---|---|
| not_started | Default status of the check |
| failed | Status when the check of a requirement fails |
| not_completed | Status when the check of the requirement isn't finished yet |
| succeeded | Status when the check of a requirement succeeded |
(reviewed field in the GET student_sessions/ responses)
| Status | Code | Description |
|---|---|---|
| unreviewed | 00 | Status after a student finished an exam session, before any reviewing takes place. It's also possible to reset the status to unreviewed, to put the session back in the reviewing queue. |
| in_review | 01 | Status when a reviewer has started reviewing an exam session but has not yet made a final decision |
| uncertain | 10 | Default status when a new session is created |
| is_reviewed_green | 000 | Status when a reviewer has completed the review of an exam session and there are no doubts on the integrity of the session |
| is_reviewed_yellow | 001 | Status when a reviewer has completed the review of an exam session but has some doubts on the integrity of the session |
| is_reviewed_red | 010 | Status when a reviewer has completed the review of an exam session and has a strong suspicion that there was an integrity breach |
| unreviewable | 011 | Status when a reviewer cannot review an exam session, for example because the recording is corrupted or missing |