Dartmouth API Developer Portal

Academic Course-Subjects API

Returns information about course subjects, including parent department.

Rating

Attribute	Value
Highly Available	Yes
Cache Refresh Interval	4 hours
Filtering	Yes

Required Scopes

None: only requires authentication to Dartmouth's login API as documented in the introduction section of this portal.

Request

GET /api/academic/course/subjects/{id}

Required Headers

Authorization: Bearer {jwt}

Parameters

Parameter Name	Type	Description	Valid values	Required

(standard filter parameters as documented in the introduction section of this portal)

Notes on usage

When {id} is excluded from the URL, all subjects are returned as a collection. This can be useful when an application needs to provide a complete list of valid selections. Standard filtering via URL parameters is also available and returns a collection; the collection will be empty if no records are qualified by the filtering.

Business Logic

The {id} and {name} attributes are sourced from the Banner stvsubj table - stvsubj_code and stvsubj_desc.

Returns

Status Code	Description
200	{id} requested exists or was not specified
404	{id} requested does not exist

Sample Request

https://api.dartmouth.edu/api/academic/course/subjects/MATH

Sample Return

{
    "cache_date": "2020-06-24T04:10:12Z",
    "department_id": "MATH",
    "id": "MATH",
    "is_active": true,
    "name": "Mathematics"
}