Skip to main content Skip to navigation

Retrieve an assessment component's marks

Retrieve marks for students on a particular assessment.

Permission requirements

The user must have Permissions.Feedback.Publish ("Release feedback to a student") on the department or module. By default, roles that have this permission are:

  • Module Manager
  • Departmental Administrator
  • User Access Manager

Information about API permissions

Definition

GET https://tabula.warwick.ac.uk/api/v1/marks/module/:fullModuleCode/:academicYear/:occurrence/component/:assessmentGroup/:sequence

URL substitution variables

:fullModuleCode The full module code, including CATS, for the assessment, e.g. cs118-15
:academicYear The academic year for the assessment, as a 4-digit start year - e.g. for 13/14, use the string 2013
:occurrence The module occurrence code for the delivery of the module for the assessment, e.g. A
:assessmentGroup The assessment group (used where students may take different sets of assessments for a module), e.g. A
:sequence The assessment sequence code for the assessment, e.g. A01

Example request

GET https://tabula.warwick.ac.uk/api/v1/marks/module/CS118-15/2019/A/component/A/A01

Response parameters

An unsuccessful response will be returned in the standard format. A successful response will return the HTTP code 200 OK and the following parameters:

success Boolean true
status The string "ok"
students An array of student component mark objects

Example response

{
  "success": true,
  "status": "ok",
  "students": [
    {
      "universityId": "4400001",
      "currentMember": true,
      "resitStudent": false,
      "mark": 32,
      "grade": "F",
      "needsWritingToSits": false,
      "outOfSync": false,
      "agreed": false
    },
	{
      "universityId": "4400002",
      "currentMember": true,
      "resitStudent": false,
      "mark": 71,
      "grade": "1",
      "needsWritingToSits": false,
      "outOfSync": false,
      "agreed": false
    },
    ...
  ]
}

Tabula API Methods