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 / Connection/Share Services / Accept/Reject Pending Meter Share Requests

Accept/Reject Pending Meter Share Requests

Updated on July 17, 2013

Description

This web service sends an accept or reject reply to a pending meter share request along with an optional note based on the information provided in the XML request.

Version

25.0

HTTP Method

POST

Resource URL

/share/meter/(meterId)

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 authorization.xsd
Response response.xsd

Example Requests

The following example accepts the share request to the meter that has an id of 86788.

POST  /share/meter/86788

<?xml version="1.0" encoding="UTF-8"?>
<sharingResponse>
    <action>Accept</action>
    <note>Your sharing request has been verified and accepted.</note>
</sharingResponse>

The following example rejects the share request to the meter that has an id of 86788.

POST  /share/meter/86788

<?xml version="1.0" encoding="UTF-8"?>
<sharingResponse>
    <action>Reject</action>
    <note>Your sharing request has been rejected.</note>
</sharingResponse>

Example Response

The following example shows that the share has been established to the meter that has an id of 86788. It also includes a link to web service to retrieve the meter.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok"/>
TEST