Green Button Developers Guide

Welcome to Green Button Developer

Green Button represents energy usage information as a set of resources as defined in the ESPI standard and uses RESTful APIs to provide standard access to information for metered resources such as electricity, gas, and water. These interfaces may be used to access and manage the metered data by using atom+xml based streams of Energy Usage Information (EUI) encapsulated within an Atom Feed.

RetailCustomer, DataCustodian & ThirdParty Actors

Green Button allows data to be exchanged between Utilities, Customers, and Third Party Services Providers. It uses standard (http) based messaging to accomplish these exchanges. So, starting with the Green Button Actors:

RetailCustomer: Any person or enterprise that is provided services such as electricity, water, or gas from a resource service provider. RetailCustomers may be residential, commercial, or industrial.
DataCustodian: Any enterprise that is holding metered data obtained during the course of providing resources to a RetailCustomer. A DataCustodian holds that data as part of the service they provide and may, with the authorization of the RetailCustomer, allow that data to be shared with a third party.
ThirdParty: Any person or enterprise that is authorized to have access to metered data held by a DataCustodian. A ThirdParty, when authorized, may subscribe to a RetailCustomer's data and provide additional services as desired.

Relationships between the Actors

The Actors enter into relationships as depicted in the diagram above. The simplest relationship is the one that exists between the DataCustodian (i.e. the Utility) and their customer (the RetailCustomer). This relationship allows the RetailCustomer to download a file that contains their resource usage information. This simple relationship is the basis for the Green Button Download My Data operation.

Concepts

Green Button uses Atom Publishing Standard to represent structured energy usage information in an XML format that may be exchanged on the internet. Both Google (GData) and Microsoft (OData) independently recognized the power of the Atom Syndication Format to encode complex data for exchange over RESTful web services. Green Button adopted these concepts in the construction of ESPI.

The resources defined within Green Button, UsagePoints, MeterReadings, etc, are expressed, in XML format, within the Atom feed's Entry tags. This results in a uniform way to expose full-featured data APIs that reference a Retail Customer's encapsulated Energy Usage Information.

Green Button works by placing data within the <entry> tags of the Atom stream. Data records are placed within the <entry> ... <content> tags, and relationships between tables are represented in the <link>tags.

The second thing to note is that in the Atom reprsentation, a feed will always represent a collection of 1 or more Green Button resources:

<feed>
  ...
  <entry>
    ...
    <content>
      <espi-resource />
    </content>
  </entry>
  ...
</feed>

Relationships

So all the espiDerived.xsd entities are always contained in a feed and the entry/content describes the espi resource itself. In addtion, you need to construct (during the parse if possible for you:) the associations that need to exist between the espi entities. The <link> tags are quite important for use during parsing of the Green Button data. These links allow you to know which MeterReadings are related to a specific UsagePoint.

Within the <entry>'s the "related" links point to a collection, for example:




<feed xmlns="http://www.w3.org/2005/Atom"
         xsi:schemaLocation="http://naesb.org/espi espiDerived.xsd"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <id>urn:uuid:728B5594-414E-471A-A230-08FCCDAC655C</id>
 <title>ThirdPartyX Batch Feed</title>
 <ns3:published>2014-01-02T10:00:00Z</ns3:published>
 <ns3:updated>2014-01-02T10:00:00Z</ns3:updated>
 <link rel="self" href="/ThirdParty/83e269c1/Batch"/>
   <entry>
   <id>urn:uuid:97EAEBAD-1214-4A58-A3D4-A16A6DE718E1</id>
     <link rel="self"
           href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/Subscription/9b6c7063/UsagePoint/01"/>
     <link rel="up"
           href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/Subscription/9b6c7063/UsagePoint"/>
     <link rel="related"
           href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/Subscription/9b6c7063/UsagePoint/01/MeterReading"/>
     <link rel="related"
           href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/Subscription/9b6c7063/UsagePoint/01/ElectricPowerUsageSummary"/>
     <link rel="related"
           href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/01"/>
     <title>my house</title>
     <ns3:published>2014-01-02T10:00:00Z</ns3:published>
     <ns3:updated>2014-01-02T10:00:00Z</ns3:updated>
     <content>
       <UsagePoint xmlns="http://naesb.org/espi">
         <ServiceCategory>
           <kind>0</kind>
         </ServiceCategory>
       </UsagePoint>
     </content>
   </entry>
 </feed>

Green Button Resources

A DataCustodian will, when authorized by a RetailCustomer, publish a GreenButton data stream. A ThirdParty may then subscribe to that stream. Green Button uses the OAuth 2.0 Authorization Framework protocol to provide secure authorization for accessing the published data stream.

Green Button APIs are designed to support data flows that are both large and small. Many Utilities will schedule bulk transfers of hundreds of thousands of 24 hour data as a batch process. In this case, the Green Button APIs must be able to accomodate blocked transfers, recovery, and restarts. Other use-cases are more driven by frequent transmissions of smaller data sets, for example the hourly usage of a single outlet in your home. Green Button is designed to handle both!

ApplicationInformation

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="/GreenButtonDataStyleSheet.xslt"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <id>urn:uuid:f30946a0-0955-466b-901a-366feb2a8424</id>
  <title>Green Button Usage Feed</title>
  <updated>2014-05-22T17:45:50Z</updated>
  <link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/ApplicationInformation" rel="self"/>
  <ns3:entry xmlns:espi="http://naesb.org/espi" xmlns:ns3="http://www.w3.org/2005/Atom">
        <ns3:id>urn:uuid:af6e8b03-0299-467e-972a-a883ecdcc575</ns3:id>
        <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/ApplicationInformation" rel="up"/>
        <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/ApplicationInformation/1" rel="self"/>
        <ns3:title>GreenButtonData.org  DataCustodian Application</ns3:title>
        <ns3:content>
              <espi:ApplicationInformation>
                    <espi:dataCustodianApplicationStatus></espi:dataCustodianApplicationStatus>
                    <espi:thirdPartyNotifyUri>https://services.greenbuttondata.org/ThirdParty/espi/1_1/Notification</espi:thirdPartyNotifyUri>
                    <espi:dataCustodianBulkRequestURI></espi:dataCustodianBulkRequestURI>
                    <espi:dataCustodianResourceEndpoint>https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource</espi:dataCustodianResourceEndpoint>
                    <espi:thirdPartyScopeSelectionScreenURI>https://services.greenbuttondata.org/ThirdParty/Subscription/ScopeSelection</espi:thirdPartyScopeSelectionScreenURI>
                    <espi:client_secret>secret</espi:client_secret>
                    <espi:redirect_uri>https://services.greenbuttondata.org/ThirdParty/espi/1_1/OAuthCallBack</espi:redirect_uri>
                    <espi:client_id>third_party</espi:client_id>
                    <espi:scope>FB=4_5_15;IntervalDuration=900;BlockDuration=monthly;HistoryLength=13</espi:scope>
                    <espi:scope>FB=4_5_15;IntervalDuration=3600;BlockDuration=monthly;HistoryLength=13</espi:scope>
                    <espi:dataCustodianId>data_custodian</espi:dataCustodianId>
                    <espi:thirdPartyApplicationName>Third Party (localhost)</espi:thirdPartyApplicationName>
              </espi:ApplicationInformation>
        </ns3:content>
        <ns3:published>2014-01-02T10:00:00Z</ns3:published>
        <ns3:updated>2014-01-02T10:00:00Z</ns3:updated>
  </ns3:entry>
</feed>

UsagePoint

A UsagePoint is where a resource is measured. Typically, it is your Utility Smart Meter, but it could be the outlet on the wall as well. UsagePoints provide the reference for all meter readings that are contained within the Green Button data. UsagePoints have a ServiceCategory that defines what kind of resource, such as electricity, gas, or water measurement is being reported.

<ns3:entry xmlns:espi="http://naesb.org/espi" xmlns:ns3="http://www.w3.org/2005/Atom">
      <ns3:id>urn:uuid:af6e8b03-0299-467e-972a-a883ecdcc575</ns3:id>
      <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/ApplicationInformation" rel="up"/>
      <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/ApplicationInformation/1" rel="self"/>
      <ns3:title>GreenButtonData.org  DataCustodian Application</ns3:title>
      <ns3:content>
            <espi:ApplicationInformation>
                  <espi:dataCustodianApplicationStatus></espi:dataCustodianApplicationStatus>
                  <espi:thirdPartyNotifyUri>https://services.greenbuttondata.org/ThirdParty/espi/1_1/Notification</espi:thirdPartyNotifyUri>
                  <espi:dataCustodianBulkRequestURI></espi:dataCustodianBulkRequestURI>
                  <espi:dataCustodianResourceEndpoint>https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource</espi:dataCustodianResourceEndpoint>
                  <espi:thirdPartyScopeSelectionScreenURI>https://services.greenbuttondata.org/ThirdParty/Subscription/ScopeSelection</espi:thirdPartyScopeSelectionScreenURI>
                  <espi:client_secret>secret</espi:client_secret>
                  <espi:redirect_uri>https://services.greenbuttondata.org/ThirdParty/espi/1_1/OAuthCallBack</espi:redirect_uri>
                  <espi:client_id>third_party</espi:client_id>
                  <espi:scope>FB=4_5_15;IntervalDuration=900;BlockDuration=monthly;HistoryLength=13</espi:scope>
                  <espi:scope>FB=4_5_15;IntervalDuration=3600;BlockDuration=monthly;HistoryLength=13</espi:scope>
                  <espi:dataCustodianId>data_custodian</espi:dataCustodianId>
                  <espi:thirdPartyApplicationName>Third Party (localhost)</espi:thirdPartyApplicationName>
            </espi:ApplicationInformation>
      </ns3:content>
      <ns3:published>2014-01-02T10:00:00Z</ns3:published>
      <ns3:updated>2014-01-02T10:00:00Z</ns3:updated>
</ns3:entry>

ReadingType

A ReadingType provides detail as to the specifics of the reading data that is being obtained. Green Button follows international standards and has the ability to represent large industrial resources as well as those used in a residence.

<ns3:entry xmlns:espi="http://naesb.org/espi" xmlns:ns3="http://www.w3.org/2005/Atom">
      <ns3:id>urn:uuid:99b292fc-55f7-4f27-a3b9-cddab97cca90</ns3:id>
      <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/ReadingType" rel="up"/>
      <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/ReadingType/1" rel="self"/>
      <ns3:title>Type of Meter Reading Data</ns3:title>
      <ns3:content>
            <espi:ReadingType>
                  <espi:accumulationBehaviour>4</espi:accumulationBehaviour>
                  <espi:commodity>1</espi:commodity>
                  <espi:currency>840</espi:currency>
                  <espi:dataQualifier>12</espi:dataQualifier>
                  <espi:flowDirection>1</espi:flowDirection>
                  <espi:intervalLength>86400</espi:intervalLength>
                  <espi:kind>12</espi:kind>
                  <espi:phase>769</espi:phase>
                  <espi:powerOfTenMultiplier>0</espi:powerOfTenMultiplier>
                  <espi:timeAttribute>0</espi:timeAttribute>
                  <espi:uom>72</espi:uom>
            </espi:ReadingType>
      </ns3:content>
      <ns3:published>2013-09-19T04:00:00Z</ns3:published>
      <ns3:updated>2013-09-19T04:00:00Z</ns3:updated>
</ns3:entry>

MeterReading

A MeterReading is a container for all of the measured IntervalBlocks within the Green Button data captured at a UsagePoint.

<ns3:entry xmlns:espi="http://naesb.org/espi" xmlns:ns3="http://www.w3.org/2005/Atom">
      <ns3:id>urn:uuid:4234ae39-fb6d-48ca-8856-ac9f41fb3d34</ns3:id>
      <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/Subscription/1/UsagePoint/1/MeterReading" rel="up"/>
      <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/Subscription/1/UsagePoint/1/MeterReading/1" rel="self"/>
      <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/Subscription/1/UsagePoint/1/MeterReading/1/IntervalBlock" rel="related"/>
      <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/ReadingType/1" rel="related"/>
      <ns3:title>Monthly Electricity Consumption</ns3:title>
      <ns3:content>
            <espi:MeterReading/>
      </ns3:content>
      <ns3:published>2013-09-19T04:00:00Z</ns3:published>
      <ns3:updated>2013-09-19T04:00:00Z</ns3:updated>
</ns3:entry>

IntervalBlock

IntervalBlocks are the primary data carrier within the Green Button data. IntervalBlocks may have one or more Intervals, each with a start and duration, as well as the specific IntervalReading

<ns3:entry xmlns:espi="http://naesb.org/espi" xmlns:ns3="http://www.w3.org/2005/Atom">
      <ns3:id>urn:uuid:e0383570-16b1-4ab9-8642-fdb7e89660db</ns3:id>
      <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/Subscription/1/UsagePoint/1/MeterReading/1/IntervalBlock" rel="up"/>
      <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/Subscription/1/UsagePoint/1/MeterReading/1/IntervalBlock/1" rel="self"/>
      <ns3:title></ns3:title>
      <ns3:content>
            <espi:IntervalBlock>
                  <espi:interval>
                        <espi:duration>2678400</espi:duration>
                        <espi:start>1357016400</espi:start>
                  </espi:interval>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1357016400</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1357102800</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1357189200</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1357275600</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>203931</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1357362000</espi:start>
                        </espi:timePeriod>
                        <espi:value>25662</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>203931</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1357448400</espi:start>
                        </espi:timePeriod>
                        <espi:value>25662</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1357534800</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1357621200</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1357707600</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1357794000</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1357880400</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>203931</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1357966800</espi:start>
                        </espi:timePeriod>
                        <espi:value>25662</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>203931</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1358053200</espi:start>
                        </espi:timePeriod>
                        <espi:value>25662</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1358139600</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1358226000</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1358312400</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1358398800</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1358485200</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>203931</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1358571600</espi:start>
                        </espi:timePeriod>
                        <espi:value>25662</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>203931</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1358658000</espi:start>
                        </espi:timePeriod>
                        <espi:value>25662</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1358744400</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1358830800</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1358917200</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1359003600</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1359090000</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>203931</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1359176400</espi:start>
                        </espi:timePeriod>
                        <espi:value>25662</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>203931</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1359262800</espi:start>
                        </espi:timePeriod>
                        <espi:value>25662</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1359349200</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1359435600</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1359522000</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
                  <espi:IntervalReading>
                        <espi:cost>256347</espi:cost>
                        <espi:timePeriod>
                              <espi:duration>86400</espi:duration>
                              <espi:start>1359608400</espi:start>
                        </espi:timePeriod>
                        <espi:value>21021</espi:value>
                  </espi:IntervalReading>
            </espi:IntervalBlock>
      </ns3:content>
      <ns3:published>2013-02-01T05:00:00Z</ns3:published>
      <ns3:updated>2013-02-01T05:00:00Z</ns3:updated>
</ns3:entry>

LocalTimeParameters

The LocalTimeParameters provide a flexible manner to enable Energy Usage Information (EUI) to be provided with a reference to local time, without including any Personal Identifiable Information.

<ns3:entry xmlns:espi="http://naesb.org/espi" xmlns:ns3="http://www.w3.org/2005/Atom">
      <ns3:id>urn:uuid:e30ce77d-ec22-4da5-83c2-991ba34c97d6</ns3:id>
      <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/LocalTimeParameters" rel="up"/>
      <ns3:link href="https://services.greenbuttondata.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/1" rel="self"/>
      <ns3:title>DST For North America</ns3:title>
      <ns3:content>
            <espi:LocalTimeParameters>
                  <espi:dstEndRule>B40E2000</espi:dstEndRule>
                  <espi:dstOffset>3600</espi:dstOffset>
                  <espi:dstStartRule>360E2000</espi:dstStartRule>
                  <espi:tzOffset>-18000</espi:tzOffset>
            </espi:LocalTimeParameters>
      </ns3:content>
      <ns3:published>2013-09-19T04:00:00Z</ns3:published>
      <ns3:updated>2013-09-19T04:00:00Z</ns3:updated>
</ns3:entry>

ElectricPowerUsageSummary

<entry>
  <id>urn:uuid:97EAEBAD-1214-4A58-A3D4-A16A6DE718E1</id>
  <published>2012-10-24T00:00:00Z</published>
  <updated>2012-10-24T00:00:00Z</updated>
  <link rel="self"
        href="/espi/1_1/resource/Subscription/9b6c7063/ElectricPowerUsageSummary/01"/>
  <link rel="up"
        href="/espi/1_1/resource/Subscription/9b6c7063/ElectricPowerUsageSummary"/>
  <title>my house</title>
  <content>
    <ElectricPowerUsageSummary xmlns="http://naesb.org/espi">
      <billingPeriod>
        <duration>2588400</duration>
        <start>1330578000</start>
      </billingPeriod>
      <billLastPeriod>20810000</billLastPeriod>
      <billToDate>8145000</billToDate>
      <costAdditionalLastPeriod>4525000</costAdditionalLastPeriod>
      <currency>840</currency>
      <overallConsumptionLastPeriod>
        <powerOfTenMultiplier>0</powerOfTenMultiplier>
        <uom>72</uom>
        <value>1951364</value>
      </overallConsumptionLastPeriod>
      <currentBillingPeriodOverAllConsumption>
        <powerOfTenMultiplier>0</powerOfTenMultiplier>
        <timeStamp>1334462400</timeStamp>
        <uom>72</uom>
        <value>1006640</value>
      </currentBillingPeriodOverAllConsumption>
      <qualityOfReading>14</qualityOfReading>
      <statusTimeStamp>1334462400</statusTimeStamp>
    </ElectricPowerUsageSummary>
  </content>
</entry>

ElectricPowerQualitySummary

 <entry>
        <id>urn:uuid:DEB0A337-C1B5-4658-99BA-4688E253A99B</id>
        <link rel="self" href="Subscription/9b6c7063/ElectricPowerQualitySummary/01"/>
        <link rel="up" type="" href="Subscription/9b6c7063/UsagePoint/01/ElectricPowerQualitySummary"/>
        <title>Quality Summary</title>
        <content>
            <ElectricPowerQualitySummary xmlns="http://naesb.org/espi">
                <flickerPlt>1</flickerPlt>
                <flickerPst>2</flickerPst>
                <harmonicVoltage>3</harmonicVoltage>
                <longInterruptions>4</longInterruptions>
                <mainsVoltage>5</mainsVoltage>
                <measurementProtocol>6</measurementProtocol>
                <powerFrequency>7</powerFrequency>
                <rapidVoltageChanges>8</rapidVoltageChanges>
                <shortInterruptions>9</shortInterruptions>
                <summaryInterval>
                    <duration>2119600</duration>
                    <start>2330578000</start>
                </summaryInterval>
                <supplyVoltageDips>10</supplyVoltageDips>
                <supplyVoltageImbalance>11</supplyVoltageImbalance>
                <supplyVoltageVariations>12</supplyVoltageVariations>
                <tempOvervoltage>13</tempOvervoltage>
            </ElectricPowerQualitySummary>
        </content>
        <published>2012-10-24T00:00:00Z</published>
        <updated>2012-10-24T00:00:00Z</updated>
    </entry>

Samples and Sandboxes

Download My Data

A RetailCustomer may download an XML file from either a Data Custodian or a Third Party. Restful interfaces are provided to enable this operation. There are no assumptions made with respect to what the RetailCustomer might do with this XML file, although best practices would be to insure the file is viewable by using a minimal stylesheet.

Examples of Download My Data files may be found on the Green Button Sandbox.

Connect My Data

The RetailCustomer may also authorize Green Button data to move between two machines, such as from their utility to a company that might use the data to estimate the energy efficiency of their facility. In this case, Connect My Data would be used to provide machine-2-machine data transfers. Connect My Data may provide a single transfer of information, or transfers on a predefined schedule.

Connect My Data RESTful APIs may be experimented with at the API Sandbox.