announcement

There has been a lapse in Environmental Protection Agency appropriations. EPA intends to keep the ENERGY STAR website, tools, and resources available, however they will not be updated regularly. If you submit a question, application, or request to EPA, it may not be processed during this period.

Web Service Documentation / Categories / Meter Services / Add Onsite Green Power Renewable Detail

Add Onsite Green Power Renewable Detail

Updated on June 30, 2024

Description

This web service creates a new onsite Green Power renewable detail record for a specific meter based on the information provided in the XML request. The corresponding meter must be an onsite renewable solar or wind meter. The meter must already be shared with you and you must have write access.

Version

25.0

HTTP Method

POST

Resource URL

/meter/(meterId)/onsiteRenewableDetails

Header

Field Name Value Comments
Authorization Basic credentials
Content-Type application/xml

Authorization Required

Yes

Parameters

Parameter Name Description
meterId Id to the meter

XML Schemas

Request/Response Schema Name
Request onsiteRenewableDetail.xsd
Response response.xsd

Example Request

The following example adds an onsite Green Power renewable detail record to a meter that has an id of 82.

POST  /meter/82/onsiteRenewableDetails

<?xml version="1.0" encoding="UTF-8"?>
<onsiteRenewableDetail>
     <currentAsOf>2021-01-01</currentAsOf>
     <energyUsedOnsite>
          <recOwnership>Not Owned/Sold</recOwnership>
     </energyUsedOnsite>
     <energyExportedToGrid>
          <recOwnership>Arbitraged</recOwnership>
          <generationLocation>
               <postalCode>21046</postalCode>
          </generationLocation>
          <greenPowerType>Unbundled RECs</greenPowerType>
          <meetVintageRequirement>true</meetVintageRequirement>
          <certifiedByGreene>true</certifiedByGreene>
     </energyExportedToGrid>
</onsiteRenewableDetail>

Example Response

The following example shows the result of adding an onsite Green Power renewable detail record.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
     <links>
          <link id="886412" hint="Not Owned/Sold/Arbitraged (2024-06-01)" linkDescription="This is the GET url for this Onsite Renewable Detail." link="/onsiteRenewableDetails/886412" httpMethod="GET"/>
     </links>
</response>
TEST