Dartmouth API Developer Portal
Academic Majors API
Returns information about majors, including parent department(s).
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/majors/{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 majors are returned as a collection. 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 stvmajr table - stvmajr_code and stvmajr_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/majors/ARTH
Sample Return
{
"cache_date": "2020-06-23T20:10:22Z",
"departments": [
{
"id": "ARTH"
},
{
"id": "SART"
}
],
"id": "ARTH",
"is_active": true,
"name": "Art History"
}