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"
}