Finance APIs

Hierarchies

View the OpenAPI specification

Hierarchies are used to capture information about how other records are organized. They can apply to different types of records.

There are 8 levels of hierarchies that apply to cost centers. These will generally align with these categories:

  • Level 1: UW System
  • Level 2: Institution
  • Level 3: Executive
  • Level 4: Division
  • Level 5: College
  • Level 6: School
  • Level 7: Department
  • Level 8: Subdepartment

Note that these categories may not always match the data. Different institutions may use the structure in different ways.

Filters

  • company
  • dttm_loaded
  • level
  • name
  • ancestorOf*
  • descendantOf*
    *please note that it is inclusive of the ID you’re using, so it will include that ID in in the response

Example response element:

{
  "id": "CCH003235",
  "type": "hierarchy",
  "attributes": {
    "company": "UWOSH",
    "name": "UWOSH | CCHL6 | FACMGMT | Auto Shop",
    "level": 6,
    "parent_id": "CCH001234"
    "subtype": "Cost_Center_Hierarchy"
  }
}

Sample filters

  • api.wisc.edu/finance/hierarchies?filter[company]=UWOSH
  • api.wisc.edu/finance/hierarchies?filter[dttmLoaded]=GREATER_THAN:2024-06-01T12:00:00
  • api.wisc.edu/finance/hierarchies?filter[level]=6
  • api.wisc.edu/finance/hierarchies?filter[name]=CONTAINS:auto
  • api.wisc.edu/finance/hierarchies?filter[ancestorOf]=CCH003235
  • api.wisc.edu/finance/hierarchies?filter[descendantOf]=CCH001234
  • api.wisc.edu/finance/hierarchies?filter[descendantOf]=CCH000001&filter[company]=UWMIL&filter[ancestorOf]=CCH003179