Retrieve a list of term dates for a specified academic year, or the current academic year if no year is specified, and the previous and next years.

Content negotiation

The API will return JSON by default, but will return iCal if the request is made with a Accept: text/calendar request header or the request URL ends with .ics.

Permission requirements

This API is public.

Definition

GET https://tabula.warwick.ac.uk/api/v1/termdates

GET https://tabula.warwick.ac.uk/api/v1/termdates.*

GET https://tabula.warwick.ac.uk/api/v1/termdates/:academicYear

GET https://tabula.warwick.ac.uk/api/v1/termdates/:academicYear.*

URL substitution variables

:academicYear	The academic year to get term dates for, as a 4-digit start year - e.g. for 13/14, use the string 2013. Defaults to the current academic year (i.e. starting from 1st August)

Example request

GET https://tabula.warwick.ac.uk/api/v1/termdates (JSON)

GET https://tabula.warwick.ac.uk/api/v1/termdates.ics (iCal)

Response parameters

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

success	Boolean true
status	The string "ok"
terms	An array of term objects, containing the following properties: name - the name of the term or vacation period start - the start date of the term or vacation, in ISO date format end - the end date of the term or vacation, in ISO date format weekRange - an object containing two properties, minWeek and maxWeek, specifying the academic week number range of the term or vacation

Example response

{
  "success": true,
  "status": "ok",
  "terms": [{
    "name": "Autumn",
    "start": "2015-10-05",
    "end": "2015-12-13",
    "weekRange": {
      "minWeek": 1,
      "maxWeek": 10
    }
  }, ...]
}