Academic Years

An academic_year object represents a school year within a particular school.

Access: This is a read-only resource managed directly by the school.

Permissions: A school level access token with the school scope is required to access academic_year information. Optionally, if the access token also has the calendar scope, then term dates will also be included where available.

List Academic Years

Returns a list of academic years for the school associated with the provided access_token. The dates of these academic years can be used to filter data in other API endpoints.


GET /academic_years
Accept: application/vnd.assembly+json; version=1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0sZZxr3r...
Parameter Default Example Description
per_page 100 25

number of results to return

page 1 2

page number to return

URI Template: /academic_years{?per_page,page}

Response 200

Content-Type: application/json; charset=utf-8
  "object": "list",
  "total_count": 3,
  "total_pages": 1,
  "current_page": 1,
  "prev_page": null,
  "next_page": null,
  "data": [
      "object": "academic_year",
      "id": 1,
      "name": "2015/2016",
      "start_date": "2015-09-01",
      "end_date": "2016-07-21",
      "terms": [
              "object": "term_date",
              "id": 2526,
              "name": "Summer Term",
              "start_date": "2016-04-11T00:00:00.000Z",
              "end_date": "2016-07-22T23:59:00.000Z"
      "object": "academic_year",
      "id": 2,
      "name": "2014/2015",
      "start_date": "2014-09-01",
      "end_date": "2015-07-21"
      "object": "academic_year",
      "id": 3,
      "name": "2013/2014",
      "start_date": "2013-09-01",
      "end_date": "2014-07-21"