This service is used to retrieve (Diploma) Exam Marks from PASI Core. This service can be used to:

1. Retrieve information about an Exam Mark from the PASI Core, and
2. Obtain updates about an Exam Mark from the PASI Core as part of the data synchronization processes.

This service can be used to get a single record or a list of records.

Normally this service is to be used during the data synchronization process as described by the Data Synchronization Services document. The Is Data Available service operation is used to determine if there are any Exam Mark changes that the PASI client is interested in. The PASI client could then call this service to return those changes.

This service can be accessed by systems with the View Transcript User role.

A request to use this service will include list of Reference IDs for the all Exam Mark records being requested with each item in the list containing (* denotes mandatory information):

• Diploma Exam Mark Reference ID*
• Expected Version

There are no validations performed on the service request.

Information for each of the Diploma Exam Mark records identified in the request will be retrieved from the PASI Core and returned in the response. If a list of records has been requested, they will be processed in the order provided.

The Exam Mark Reference IDs provided in the request are validated and the result is returned in the Availability Status:

• Unknown if the Exam Mark Reference ID provided is unknown in the PASI Core;
• No Access if the PASI Client does not have access to the record being requested; or
• Normal if the record(s) has been returned.

When an Expected Version is provided in the request for an Exam Mark record:

• If the Expected Version requested is ‘0’, the record will be returned.
• If the Expected Version requested is the same as the PASI Version of the record, the record will be returned.
• If the Expected Version requested is not the same as the PASI Version of the record, the record will not be returned and no further requested records will be processed.

The service will return responses on specified Exam Marks when the client has one of the following:

• Association to the student that is linked to the Exam Mark OR the primary ASN of the student that is linked to the Exam Mark:
  • By Ministry,
  • By Current School Enrolment,
  • By Last School Enrolment,
  • By Recent School Enrolment

• Association to the Writing Centre, or an organization associated to the Writing Centre, that owns¹⁾ one or more exam mark components for the exam mark.

Availability Status will be returned for each requested Diploma Exam Mark record.

The response will contain a list of the Diploma Exam Mark records (and associated Diploma Exam Mark Components) requested with an Availability Status of Normal:

• Diploma Exam Mark Audit Information
  • Audit User
  • Audit User Organization
  • Last Updated On
  • PASI Core Version
• Diploma Exam Mark Component *
  • Component Code
  • Diploma Exam Mark Component Mark Format
  • Component Maximum Mark
  • Exam Sitting Reference ID *
  • Form ID
  • Component Mark Status *
  • Mark Value
  • Supplied Contact Name (Note: This is returned starting with the 2016 endpoint.)
• Diploma Exam Mark Exam
• Diploma Exam Mark Status *
• Diploma Exam Mark Value
• Diploma Exam Mark Is Deleted *
• Is Rescored *
• Diploma Exam Mark Reference ID *
• Diploma Exam Mark Student *