Skip to main content Skip to navigation

Retrieve Holiday Dates

Retrieve a list of statutory and customary holiday dates known to the system.

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/holidaydates

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

Example request

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

GET https://tabula.warwick.ac.uk/api/v1/holidaydates.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"
dates An array of holiday dates, in ISO date format

Example response

{
  "success": true,
  "status": "ok",
  "dates": [
    "2012-12-24",
    "2012-12-25",
    "2012-12-26",
  ...]
}
Customary and statutory holidays

This calendar contains "out-of-office" events for days marked as customary or statutory University holidays.

Subscribe to calendar

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

Tabula API Methods