University of Wisconsin–Madison

Locations

The /locations endpoint is the core of the Locations API. Each location record has the following attributes:

Attribute nameExampleNotes
activetrue
address1123 Fake St.
addressCountryUSA
addressMunicipalityStateville
addressPostalCode54466
addressRegionWisconsin
addressRegionDescriptorState
addressRegionSubdivisionWood
addressRegionSubdivisionDescriptorCounty
buildingNameBuckington HallJust the name of the building (if applicable), no IDs or other concatenated attributes
buildingNumber1234
wdCreatedOn2025-07-01
wdLastModified2025-07-01
hierarchyIdLH_UWABC
LH_UWABC_BRANCHCAMPUS
For locations within branch campuses, hierarchy IDs include the ID of both the parent campus and the branch.
inactiveDate2025-07-01Only present if active is false
referenceIdLCABC_0123A_NA_3030The full ID for a location. Use this as a filter criterion if you want to get just one location back.
fullNameBlue Gym-2345-01-5555The full name for a location. Includes the name and ID of the building along with floor and room IDs (if applicable). Most API users will be more interested in the buildingName and roomName attributes.
roomNameBucky Badger AuditoriumMost rooms don’t have names, but a few do
roomNumber4567
superiorBranchCampusIdLCABC_BRNOnly populated if the location belongs to a branch campus
superiorBuildingIdLCABC_0123AOnly populated if the location belongs to a building or non-building
superiorCampusIdLCABCPopulated for all locations except the very top level (UW System)
superiorFloorIdLCABC_0123A_03Only populated if the location belongs to a floor
superiorLocationIdLCABC_0123A_03The ID of the immediate superior location, no matter what type it is. Usually less useful than superiorBuildingId or superiorCampusId.
typeBuildingSee Types for more details
usagesWORK SPACESee Usages for more details