Academic terms

API version
Select a version to change the base URI
in syntax and code examples. Learn about versions
:

Represents a list of configured academic terms.

URI
/api/v9/academic-terms 

API request	Return Type	Verb	Description
`/api/v9/academic-terms`	C	,	Get a list of all configured academic terms
`/api/v9/academic-terms/id`	R	,	Get information about an academic term
`/api/v9/academic-terms/types`	C	,	Get a list of all configured academic term types
`/api/v9/academic-terms/types/ID`	R	,	Get information about an academic term type

List academic terms

List academic terms configured into the system. These are the main “buckets” where applications are categorized. An example of an academic term is Fall 2016 or Spring 2017.

Syntax
GET /api/v9/academic-terms
Host: apply.example.edu
Authorization: DREAM apikey="..."

Example request

Request
curl
curl \
  -X GET \
  -H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
  "https://apply.example.edu/api/v9/academic-terms"

Response headers

Header	Value	Description
`Content-Type`	`application/json`	Media type of the resource
`Content-Length`	`1234`	Size of the response body in bytes
`X-Count`	`2`	Number of configured academic terms

Response codes

Response code	Description
`200 OK`	The list of academic terms was successfully returned

Example response

Response
{
  "26": {
    "id": 26,
    "year": "/api/v9/academic-years/2025",
    "name": "Spring semester 2025/26",
    "type": "/api/v9/academic-terms/types/2",
    "start": "2026-01-01",
    "grace": "2026-01-15",
    "finish": "2026-05-31"
  },
  "27": {
    "id": 27,
    "year": "/api/v9/academic-years/2025",
    "name": "Fall semester 2025/26",
    "type": "/api/v9/academic-terms/types/1",
    "start": "2025-09-01",
    "grace": "2025-09-15",
    "finish": "2025-12-31"
  },
  "28": {
    "id": 28,
    "year": "/api/v9/academic-years/2026",
    "name": "Fall semester 2026/27",
    "type": "/api/v9/academic-terms/types/1",
    "start": "2026-09-01",
    "grace": "2026-09-15",
    "finish": "2026-12-25"
  },
  "31": {
    "id": 31,
    "year": "/api/v9/academic-years/2026",
    "name": "Spring semester 2026/27",
    "type": "/api/v9/academic-terms/types/2",
    "start": "2027-01-01",
    "grace": "2027-06-15",
    "finish": "2027-06-01"
  }
}

Fees

Academic term