Retrieve a Module Timetable
Retrieve a list of all scheduled timetable events for the current year that are assigned to the specified module.
Currently, this interface only includes data in Syllabus+. It's safe to use this API on the assumption that if other sources are added, they will be opt-in.
Permission requirements
The user must have Permissions.Module.ViewTimetable
("View a module's timetable") on the module. By default, all logged-in users have this permission on all modules.
Information about API permissions
Definition
GET https://tabula.warwick.ac.uk/api/v1/module/:moduleCode/timetable
URL substitution variables
:moduleCode |
The lowercase form of the module code to get the timetable for, e.g. cs118 |
---|
Request parameters
academicYear Optional |
The academic year to fetch the timetable, in the format yy/yy - e.g. 13/14. Defaults to the current SITS academic year (runs 1st August to 31st July) |
---|
Note: The Syllabus+ dataset usually only keeps information for the current academic year. There is a period during August and September where the "calendar" academic year is different to the current "SITS" academic year; i.e. the SITS academic year rolls over "early" to the new academic year. During this time, it may be preferable to explicitly state which academic year you wish to retrieve events for.
Example request
GET https://tabula.warwick.ac.uk/api/v1/module/cs118/timetable?academicYear=13%2f14
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" |
events |
An array of timetable event objects |
Example response
{
"success": true,
"status": "ok",
"events": [
{
"eventType": "Lecture",
"startTime": "15:00",
"location": {
"name": "MS.01",
"locationId": "41283"
},
"description": "",
"context": "CS118",
"staffUniversityIds": [
"0603723",
"1170047"
],
"year": "14/15",
"weekRanges": [
{
"minWeek": 1,
"maxWeek": 10
}
],
"endTime": "16:00",
"uid": "45bbe3265829ec49817b4dcb0c51115b",
"title": "",
"name": "CS118L",
"day": "Thursday",
"comments": null
},
{
"eventType": "Lecture",
"startTime": "15:00",
"location": {
"name": "H0.52",
"locationId": "21337"
},
"description": "",
"context": "CS118",
"staffUniversityIds": [
"0603723",
"1170047"
],
"year": "14/15",
"weekRanges": [
{
"minWeek": 2,
"maxWeek": 10
}
],
"endTime": "16:00",
"uid": "8149a1f09e05134d5213fe65defaa30f",
"title": "",
"name": "CS118L",
"day": "Monday",
"comments": null
}
]
}
Tabula API Methods
- Overview
- The Member object
- The StudentCourseDetails object
- The StudentCourseYearDetails object
- The StudentRelationship object
- The Student RelationshipType object
- The ModuleRegistration object
- Retrieve a member
- Retrieve multiple members
- Retrieve a member's relationships
- List relationship agents in dept.
- Search for members