Coronavirus (Covid-19): Latest updates and information
Skip to main content Skip to navigation

Retrieve Term Dates

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
    }
  }, ...]
}
Term dates

This calendar contains events that span entire terms with the term name in them, and includes vacations.

Subscribe to calendar

If you're using an external application such as Google Calendar, copy this link: Link for Google Calendar

Tabula API Methods