Dartmouth API Developer Portal

Academic Courses API

Returns information about courses. A course object holds basic course information that can span multiple terms. A history of course changes is maintained via term_code_effective. Course attributes include major, subject, and department.

Rating

Attribute	Value
Highly Available	Yes
Cache Refresh Interval	30 minutes
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/courses/{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 courses 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.

Historical information is available for courses (i.e. earlier versions of a course with a particular subject and course number) through queries on term_code_effective. To get current courses only, query is_active=true.

Business Logic

The {id} attribute is constructed from other attributes using the following format: {subject_id}.{course_number}-{term_code_effective}.

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/courses/AAAS.023-201503

Sample Return

{
    "cache_date": "2020-05-01T19:27:13Z",
    "course_number": "023",
    "culture_options": [
        {
            "id": "VCI"
        }
    ],
    "department_id": "AAAS",
    "distributives": [
        {
            "id": "VSOC"
        }
    ],
    "course_attributes": [],
    "division_id": "ACAD",
    "id": "AAAS.023-201503",
    "is_active": true,
    "is_credit_nocredit": false,
    "name": "Black Sporting Experience",
    "non_recording_options": [
        {
            "id": "1"
        },
        {
            "id": "2"
        },
        {
            "id": "3"
        },
        {
            "id": "4"
        },
        {
            "id": "5"
        },
        {
            "id": "6"
        },
        {
            "id": "7"
        },
        {
            "id": "8"
        },
        {
            "id": "9"
        },
        {
            "id": "N"
        }
    ],
    "orc_description": "<p>This course examines the historical and contemporary sporting experiences primarily of Black Americans. The decision to refer to this class as a &ldquo;Black&rdquo; experience is deliberate, as we will briefly interrogate how race and sports functions for the Black diaspora in the Caribbean, Latin America, and Europe. Despite brief examinations of the diaspora, this class uses sports history as a critical lens to understand American history.</p>\n\r<p>Cross list with HIST 30</p>",
    "orc_title": "The Black Sporting Experience",
    "prerequisites": null,
    "repeat_limit": null,
    "schools": [
        {
            "id": "UG"
        }
    ],
    "status_id": "A",
    "subject_id": "AAAS",
    "term_code_effective": "201503",
    "valid_crosslists": [
        {
            "id": "953-201703"
        }
    ],
    "valid_section_types": [
        {
            "id": "L"
        }
    ]
}