JSON Export of the Candidate Results Report & some Key Updates

This article provides details about the Candidate Results Report in JSON format, including updates to the standard structure.

The Candidate Results Report JSON export includes details about the exam delivery, candidate information, and exam results. Below are the primary components of the report and the new updates incorporated:

Structure Overview

The Candidate Results Report includes detailed information organized into several key sections:

• deliverableId: Unique identifier for the delivery.
• deliveryDateTime: Date and time when the exam started.
• deliveryCompletedDateTime: Completion timestamp.
• bookingId: Booking reference ID.
• eligibilityId: Eligibility identifier.
• deliveryType: Type of delivery (e.g., Live Proctored).
• New Field: secureBrowser: Indicates if Secure Browser was used.
• status: Current status of the delivery.
• completeReasonCode: Reason for delivery completion.
• New Field: deliveryCountry:
  • countryCode: ISO country code.
  • countryName: Full name of the country.
• deliveryExceptions: Includes any delivery-related exceptions (e.g., timeExtension).

2. Exam Reservation Fields

• reservationDateTime: Scheduled date/time of the exam.
• candidateReservationDateTime: Date/time booked by the candidate.
• storeExamSku: SKU reference for the exam.

• candidateId: Internal ID for the candidate.
• orgCandidateId: Organization-specific candidate identifier.
• firstName and lastName: Candidate's name.
• email: Candidate's email address.

4. Exam Information

• examName: Name of the exam.
• examCode: Unique code for the exam.
• examFormName: Form name used for the exam.
• examFormId: Unique ID for the exam form.
• languageCode and languageName: Language in which the exam is delivered.

• passFail: Whether the candidate passed or failed.
• reportedScore: Score reported to the candidate.
• cutScore: Minimum score required to pass.
• cutScoreType: Type of cut score (e.g., PercentScore).
• maxRawScore: Maximum possible raw score.
• rawScore: Candidate's raw score.
• percent: Candidate's percentage score.
• timeOnExam: Time spent on the exam.
• maxTimeOnExam: Maximum allowed time.
• isRescore: Whether the exam was rescored.

6. Test Parts Fields

• testPartName: Name of the test part.
• maxScore: Maximum possible score for the part.
• rawScore: Candidate’s raw score for the part.
• percent: Percentage score for the part.
• rootSections: Includes details about individual sections and items.

Sample JSON Structure with Updates

Below is an example of the updated JSON structure with the new fields included:

Changes to the Standard JSON Results Format

1. Secure Browser Information

• Field Added: secureBrowser
• Example: 

2. Test Delivery Country

• Field Added: deliveryCountry
  • Subfields:
  • countryCode: The ISO country code.
  • countryName: The full country name.
• Example: