Dartmouth API Developer Portal

Advancement Giving Summaries API

The Advancement Giving Summaries API provides Dartmouth gift-giving information either as a collection of objects related to a donor's netid, or as a single giving summary record as specified by the resource's unique id.

This is a restricted service and is strictly limited to external system integrations. Application to use this service must be approved by the General Accounting office. Usage of this API is monitored and audited by the General Accounting office on a daily basis.

Notes on usage

The primary use case of this API is to retrieve a collection of giving summary objects for an entity identified by a netid. A second, less likely, use case is to retrieve a single giving summary object identified by a unique ID.

This information is regarded as highly sensitive. All requests to this API require the scope shown below.

Required Scope

urn:dartmouth:advancement.giving_summaries:read.sensitive

Sample Request (retrieve for a given netid)

GET /api/advancement/giving_summaries?netid=d1234xx

Query Parameters

Body

none

Returns

Sample returned data

// this information is too sensitive for public display; contact xxx@dartmouth.edu for more information

Sample Request (retrieve for a given id)

GET /api/advancement/giving_summaries/{id}

URI Parameters

Body

none

Returns

Sample returned data

// this information is too sensitive for public display; contact xxx@dartmouth.edu for more information