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 / 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