Note: Version 2 of the Surpass API is now available. For any customers not already using API v1, please refer to the API v2 Developer Portal.The GetDetailedResult web method in the Surpass API returns detailed item level information regarding the test/result that was passed into the parameters of the call. This includes information such as the grade, mark, candidate, centre and item level response breakdown; further information has been provided below.
The input parameters that are required for the GetDetailedResult web method are as follows:
|Keycode||String, mandatory|| The keycode of the result you are trying to retrieve, this information is provided as part of the response from the GetDetailedResults web method.|
The GetDetailedResult web method can be called directly by browsing to the url, the keycode parameter will need to form part of the url that is sent.
An example of this call is as follows:
To successfully call GetDetailedResult the user specified in the header of the request must have the 'View Results' permission in Surpass and be associated to the relevant centre and subject of the exam that is contained within the request.
Depending on how the request was submitted the response will be in either JSON or XML format, the response will return detailed item level information of the result that was requested as part of the input parameters.
If the call was unsuccessful then you will receive an error message, all error messages available in the Surpass API can be found here.