Get Year Terms

Year Terms are a sub-set of Academic Years. Each Academic year has four terms:

  1. Fall (F)
  2. Winter (W)
  3. Spring (S)
  4. Summer (Su)

Each term also belongs to an Academic Year. In most cases, the Year Term information will be provided for you in the API response.

Api

Route
/yearterms/api
Method
GET
Key Required
No
Common Response
No

Sample Response

[
  {
    "yearTermCode": "W2023",
    "id": 288,
    "beginDate": "2023-01-01T00:00:00",
    "endDate": "2023-04-01T00:00:00",
    "description": "Winter 2023",
    "code": "W2023"
  },
  {
    "yearTermCode": "S2023",
    "id": 289,
    "beginDate": "2023-04-01T00:00:00",
    "endDate": "2023-07-01T00:00:00",
    "description": "Spring 2023",
    "code": "S2023"
  },
  {
    "yearTermCode": "Su2023",
    "id": 290,
    "beginDate": "2023-07-01T00:00:00",
    "endDate": "2023-10-01T00:00:00",
    "description": "Summer 2023",
    "code": "Su2023"
  },
  {
    "yearTermCode": "F2023",
    "id": 291,
    "beginDate": "2023-10-01T00:00:00",
    "endDate": "2024-01-01T00:00:00",
    "description": "Fall 2023",
    "code": "F2023"
  }
]

Response Fields

id (int)
Represents the Term’s unique ID.
code (string)
A display value representation of the term
yearTermCode (string)
A display value representation of the term (same as code)
beginDate (date)
The date at which the term begins
endDate (date)
The data at which the term ends
description (string)
A textual description of the term

In other API results, the code value of the Year Term will be included for you where applicable. The front part of the code value can be used to determine what term name it is (Fall, Winter, Spring, Summer).

Curl

curl -X GET --header 'Accept: application/json' 'https://prod.assistng.org/YearTerms/api/Get'