The API permits downloads of CSV data and also returns JSON. The data available includes campus-wide energy metrics and buildling level usage.
To access the API you need to get approved for an API Key. Submit the form below at this link to request approval.
For more information on "Campus as Lab" research and projects, visit the Campus as Lab website. For more data or more details, contact the Office of Sustainability.
In the CSV Files, all campus or building fields are returned.
In the JSON API, you must request a specific data point.
dekatherm (dthr). A dekatherm is equivalent to 1000 cubic feet of natural gas (think of a cube, 10 feet on a side).
tons of cooling (ktons). A ton of cooling is equivalent to the amount of heat (removal) associated with melting 2000 pounds of ice over a 24 hour period.
kilowatt (kW). A watt represents a rate of energy use -- 1 joule per second. A kilowatt is 1000 joules per second of energy being consumed.
kilowatt-hour (kWh). One kwh equals 3,600,000 joules of energy.
thousand pounds per hour (kpph). The campus can use up to 200,000 pounds of steam per hour. This is equivalent to about 237 million BTU per hour.
pounds per square inch (lbs/sqin). Measurement of steam pressure.
| Time (UTC) | Time stamp in UTC. |
|---|---|
| Boilers.1.NGas_dthr | dthr of natural gas used to fuel boilers that create steam. |
| Chillers.i.Totals.ktons | ktons Chilled water is used to cool the campus, and can also be used as an energy reserve. |
| Cogen.Turbine.NGas_dthr | dthr of natural gas consumed by the gas turbine that generates electricity. |
| Cogen.Turbine.output_kW | kw of power produced by the gas turbine. |
| Plant.i.Campus_STMF_kpph | kpph of steam distributed to campus. |
| Plant.i.Total_STMF_kpph | kpph of steam produced in total. |
| Power.Charlton.Total_kW | kW of power drawn from the grid at the Charlton Street Substation. |
| Power.ElmSub.Total_kW | kW of power drawn from the grid at the Elm Substation. |
| SMPL.SteamPress7041 | lbs/sqin of steam pressure in the steam system. |
| WestWindsor.PV_kW | kw of power produced at the solar field. |
| electricity.purchased_kW | kW total of power drawn from the grid. |
| electricity.total_kW | kW total of campus wide power demand. |
| natural_gas.total_dthr | dthr total of campus natural gas demand. |
| Time (UTC) | Time stamp in UTC. |
|---|---|
| [BuildingName].kW | kW. Rate of energy demand in kilowatts. |
| [BuildingName].kWh | kWh. Total energy consumption in kilowatt-hours. |
Valid point names for the buildings data set:
1915Hall.kW
1915Hall.kWh
1927Hall.kW
1927Hall.kWh
1937Feinberg.kW
1937Feinberg.kWh
1938Hall.kW
1938Hall.kWh
1939Hall.kW
1939Hall.kWh
Blair.kW
Blair.kWh
BlairBuyers.kW
BlairBuyers.kWh
Bloomberg.kW
Bloomberg.kWh
Butler.kW
Butler.kWh
Butler.wv.kW
Butler.wv.kWh
Buyers.kW
Buyers.kWh
CampbellR.kW
CampbellR.kWh
DodgeOsborn.kW
DodgeOsborn.kWh
Edwards.kW
Edwards.kWh
Forbes.kW
Forbes.kWh
Gauss.kW
Gauss.kWh
Hamilton.kW
Hamilton.kWh
Holder.kW
Holder.kWh
JolineCampbell.kW
JolineCampbell.kWh
JolineCampbellM.kW
JolineCampbellM.kWh
Little.kW
Little.kWh
Mathey.wv.kW
Mathey.wv.kWh
Rocky.wv.kW
Rocky.wv.kWh
Whitman.kW
Whitman.kWh
Wilcox.kW
Wilcox.kWh
Wilson.wv.kW
Wilson.wv.kWh
Witherspoon.kW
Witherspoon.kWh
https://tiger-energy.appspot.com/data/[YOUR-API-KEY]/[buildings|campus]-(year)-(month)https://tiger-energy.appspot.com/data/ABC123/campus-2016-7All hourly campus-wide energy readings in July
2016.https://tiger-energy.appspot.com/data/ABC123/buildings-2016-6All hourly building-level energy readings in June 2016.
https://tiger-energy.appspot.com/data/json/[YOUR-API-KEY]/[data-set-name]/[point-name]?start=2022-10-01&end=2022-10-05
Data Set Name is either 'campus' or 'buildings'
Point Name is one of the points in the campus or buildings data set (listed on the Introduction page)
Start and end values can be timestamps in the format YYYY-MM-DD
Solar Array
Gas
Turbine
Steam
Turbines
Chilled
Water
Steam
Steam Pressure
Purchased Natural Gas
Purchased
Grid Power
Butler College
Forbes College
Mathey College
Rockefeller College
Wilson College
Whitman College