Dartmouth API Developer Portal

Academic Divisions API

Returns information about departments, including associate dean and assistant.

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/divisions/{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 divisions 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 stvdivs table - stvdivs_code and stvdivs_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/divisions/ACAD

Sample Return

{
    "assistant": {
        "netid": "d13065e",
        "term_code_effective": "202001"
    },
    "associate_dean": {
        "netid": "d32088w",
        "term_code_effective": "202001"
    },
    "cache_date": "2020-06-23T20:10:17Z",
    "id": "ACAD",
    "is_active": true,
    "name": "Interdisciplinary Programs"
}