announcement

During the current lapse in appropriations, EPA intends to keep the ENERGY STAR website, tools, and resources available, however they will not be updated regularly. Many services may not be available during this time.

Web Service Documentation / Categories / Property Use Services / Get Use Details Revision History

Get Use Details Revision History

Updated on August 25, 2019

Description

This web service retrieves the use details revision history for a specific property use. The corresponding property must be already shared with you.

Version

25.0

HTTP Method

GET

Resource URL

/propertyUse/(propertyUseId)/useDetailsRevisions?currentAsOfStart=(YYYY-MM-DD)&currentAsOfEnd=(YYYY-MM-DD)

Header

Field Name Value Comments
Authorization Basic credentials

Authorization Required

Yes

Parameters

Parameter Name Description
propertyUseId Id of the property use

XML Schemas

Request/Response Schema Name
Request None
Response useDetailsRevisions.xsd

Example Request

The following example retrieves the use details information for a property use that has an id of 14. If you want to just retrieve use detail records that cover a date range of January 1st, 2002 to December 31st, 2002 then the following URL parameters should be provided: currentAsOfStart=2002-01-01&currentAsOfEnd=2002-12-31

GET  /propertyUse/14/useDetailsRevisions

Example Response

The following example returns the information for the space attribute.

<?xml version="1.0" encoding="UTF-8"?>
<useDetails>
     <totalGrossFloorArea units="Square Feet" id="24373669" currentAsOf="2004-01-01" temporary="false" default="N/A">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-11-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>12440</value>
     </totalGrossFloorArea>
     <totalGrossFloorArea units="Square Feet" id="24373770" currentAsOf="2005-01-01" temporary="false" default="N/A">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2014-05-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2014-05-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>12440</value>
     </totalGrossFloorArea>
     <numberOfComputers id="24371777" currentAsOf="2004-01-01" temporary="false" default="No">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-11-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>20</value>
     </numberOfComputers>
     <numberOfComputers id="24373777" currentAsOf="2005-01-01" temporary="false" default="No">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2014-05-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2014-05-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>20</value>
     </numberOfComputers>
     <numberOfWalkInRefrigerationUnits id="24373779" currentAsOf="2004-01-01" temporary="false" default="No">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-11-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>0</value>
     </numberOfWalkInRefrigerationUnits>
     <numberOfWorkers id="24373773" currentAsOf="2004-01-01" temporary="false" default="No">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-11-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>20</value>
     </numberOfWorkers>
     <studentSeatingCapacity id="24373774" currentAsOf="2004-01-01" temporary="false" default="No">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-11-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>20</value>
     </studentSeatingCapacity>
     <gymnasiumFloorArea units="Square Feet" id="24373771" currentAsOf="2004-01-01" temporary="false" default="Yes">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-12-05T17:08:07.000-05:00</lastUpdatedDate>
          </audit>
          <value>0</value>
     </gymnasiumFloorArea>
     <openOnWeekends id="24373776" currentAsOf="2004-01-01" temporary="false" default="No">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-11-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>Yes</value>
     </openOnWeekends>
     <cookingFacilities id="24373778" currentAsOf="2004-01-01" temporary="false" default="No">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-11-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>No</value>
     </cookingFacilities>
     <isHighSchool id="24373772" currentAsOf="2004-01-01" temporary="false" default="No">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-11-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>Yes</value>
     </isHighSchool>
     <percentCooled id="24373781" currentAsOf="2004-01-01" temporary="false" default="No">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-11-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>100</value>
     </percentCooled>
     <percentHeated id="24373780" currentAsOf="2004-01-01" temporary="false" default="No">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-11-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>100</value>
     </percentHeated>
     <monthsInUse id="24373775" currentAsOf="2004-01-01" temporary="false" default="N/A">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-11-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
          <value>12</value>
     </monthsInUse>
     <schoolDistrict id="24373782" currentAsOf="2003-01-01" temporary="false" default="N/A">
          <audit>
               <createdBy>WILLAMSR</createdBy>
               <createdByAccountId>803344</createdByAccountId>
               <createdDate>2013-11-07T10:11:06.000-05:00</createdDate>
               <lastUpdatedBy>WILLAMSR</lastUpdatedBy>
               <lastUpdatedByAccountId>803344</lastUpdatedByAccountId>
               <lastUpdatedDate>2013-11-07T10:11:06.000-05:00</lastUpdatedDate>
          </audit>
     </schoolDistrict>
</useDetails>
TEST