Green Button ESPI API (1.1.0)

Download OpenAPI specification:

URL: https://www.greenbuttonalliance.org License: Apache 2.0

The Green Button Energy Services Provider Interface (ESPI) API provides RESTful access to energy usage data following the NAESB REQ.21 ESPI standard. This API enables Data Custodians and Third Party Applications to exchange energy usage information using Atom-formatted XML feeds.

Interactive API Explorer: Try out the API using Swagger UI

All resources are returned as Atom feeds (collections) or Atom entries (individual resources) using the application/atom+xml content type. The ESPI data elements are embedded within the Atom <content> element using the http://naesb.org/espi XML namespace.

Green Button Alliance Developer Resources

Authentication

This API uses OAuth 2.0 for authentication and authorization. Access tokens are obtained through the standard OAuth 2.0 authorization code flow or client credentials flow. The Bearer token must be provided in the HTTP Authorization header for all API requests.

Resource Hierarchy

The ESPI data model follows this hierarchy:

Subscription > UsagePoint > MeterReading > IntervalBlock
UsagePoint > ElectricPowerQualitySummary
UsagePoint > UsageSummary
MeterReading > ReadingType (referenced)
LocalTimeParameters (standalone)

Data Custodian vs Subscription Endpoints

Resources can be accessed through two patterns:

Data Custodian endpoints (/espi/1_1/resource/{Resource}) - Used with a data_custodian_access_token for administrative access to all resources.
Subscription endpoints (/espi/1_1/resource/Subscription/{subscriptionId}/...) - Used with a customer access_token for scoped access to authorized resources.

ApplicationInformation

Operations for managing Third Party Application registration information with the Data Custodian.

Retrieve all Application Information resources [FB_33]

Returns an Atom feed containing all Application Information resources registered with the Data Custodian. Requires a valid data_custodian_access_token.

Authorizations:

oauth2

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:7c9a4e82-3b57-5a01-9c4f-2d8e6b3a1f04</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ApplicationInformation" type="espi-feed/ApplicationInformation"/>
  <title>ApplicationInformation</title>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <entry>
    <id>urn:uuid:af6e8b01-3c52-5d19-84a3-7f2e9d4b6c08</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ApplicationInformation/247931" type="espi-entry/ApplicationInformation"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ApplicationInformation" type="espi-feed/ApplicationInformation"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>ApplicationInformation</title>
    <content>
      <ApplicationInformation xmlns="http://naesb.org/espi">
        <dataCustodianId>DATA_CUSTODIAN_001</dataCustodianId>
        <dataCustodianApplicationStatus>3</dataCustodianApplicationStatus>
        <thirdPartyApplicationDescription>Energy analytics platform for residential customers</thirdPartyApplicationDescription>
        <thirdPartyApplicationStatus>3</thirdPartyApplicationStatus>
        <thirdPartyApplicationType>1</thirdPartyApplicationType>
        <thirdPartyApplicationUse>1</thirdPartyApplicationUse>
        <thirdPartyPhone>555-123-4567</thirdPartyPhone>
        <authorizationServerUri>https://data.greenbuttonconnect.org/DataCustodian</authorizationServerUri>
        <thirdPartyNotifyUri>https://thirdparty.example.com/espi/1_1/Notification</thirdPartyNotifyUri>
        <authorizationServerAuthorizationEndpoint>https://data.greenbuttonconnect.org/DataCustodian/oauth/authorize</authorizationServerAuthorizationEndpoint>
        <authorizationServerRegistrationEndpoint>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/register</authorizationServerRegistrationEndpoint>
        <authorizationServerTokenEndpoint>https://data.greenbuttonconnect.org/DataCustodian/oauth/token</authorizationServerTokenEndpoint>
        <dataCustodianBulkRequestURI>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Batch/Bulk</dataCustodianBulkRequestURI>
        <dataCustodianResourceEndpoint>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource</dataCustodianResourceEndpoint>
        <client_secret>secret_abcdef123456</client_secret>
        <logo_uri>https://thirdparty.example.com/logo.png</logo_uri>
        <client_name>GreenEnergy Analytics</client_name>
        <client_uri>https://thirdparty.example.com</client_uri>
        <redirect_uri>https://thirdparty.example.com/espi/1_1/OAuthCallBack</redirect_uri>
        <client_id>third_party_247931</client_id>
        <tos_uri>https://thirdparty.example.com/tos</tos_uri>
        <policy_uri>https://thirdparty.example.com/privacy</policy_uri>
        <software_id>GreenEnergy_Analytics</software_id>
        <software_version>2.1.0</software_version>
        <client_id_issued_at>1697823155</client_id_issued_at>
        <client_secret_expires_at>0</client_secret_expires_at>
        <contacts>admin@thirdparty.example.com</contacts>
        <token_endpoint_auth_method>client_secret_basic</token_endpoint_auth_method>
        <scope>FB=1_3_4_5_8_13_14_15_18_19_31_32_33_34_35_37_39;IntervalDuration=900;BlockDuration=monthly;HistoryLength=13</scope>
        <grant_types>authorization_code</grant_types>
        <grant_types>client_credentials</grant_types>
        <grant_types>refresh_token</grant_types>
        <response_types>code</response_types>
        <registration_client_uri>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ApplicationInformation/247931</registration_client_uri>
        <registration_access_token>reg_token_d4e5f6a7b8c9</registration_access_token>
      </ApplicationInformation>
    </content>
  </entry>
</feed>

Retrieve an Application Information resource by its ID [FB_3]

Returns an Atom entry containing the Application Information resource identified by the given ID. Requires a valid data_custodian_access_token or registration_access_token.

Authorizations:

oauth2

path Parameters

applicationInformationId

required

string

The ID of the Application Information to be retrieved.

Responses

Response samples

200

Content type

application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:af6e8b01-3c52-5d19-84a3-7f2e9d4b6c08</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ApplicationInformation/247931" type="espi-entry/ApplicationInformation"/>
  <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ApplicationInformation" type="espi-feed/ApplicationInformation"/>
  <published>2023-10-20T17:32:35.448812Z</published>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <title>ApplicationInformation</title>
  <content>
    <ApplicationInformation xmlns="http://naesb.org/espi">
      <dataCustodianId>DATA_CUSTODIAN_001</dataCustodianId>
      <dataCustodianApplicationStatus>3</dataCustodianApplicationStatus>
      <thirdPartyApplicationDescription>Energy analytics platform for residential customers</thirdPartyApplicationDescription>
      <thirdPartyApplicationStatus>3</thirdPartyApplicationStatus>
      <thirdPartyApplicationType>1</thirdPartyApplicationType>
      <thirdPartyApplicationUse>1</thirdPartyApplicationUse>
      <thirdPartyPhone>555-123-4567</thirdPartyPhone>
      <authorizationServerUri>https://data.greenbuttonconnect.org/DataCustodian</authorizationServerUri>
      <thirdPartyNotifyUri>https://thirdparty.example.com/espi/1_1/Notification</thirdPartyNotifyUri>
      <authorizationServerAuthorizationEndpoint>https://data.greenbuttonconnect.org/DataCustodian/oauth/authorize</authorizationServerAuthorizationEndpoint>
      <authorizationServerRegistrationEndpoint>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/register</authorizationServerRegistrationEndpoint>
      <authorizationServerTokenEndpoint>https://data.greenbuttonconnect.org/DataCustodian/oauth/token</authorizationServerTokenEndpoint>
      <dataCustodianBulkRequestURI>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Batch/Bulk</dataCustodianBulkRequestURI>
      <dataCustodianResourceEndpoint>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource</dataCustodianResourceEndpoint>
      <client_secret>secret_abcdef123456</client_secret>
      <logo_uri>https://thirdparty.example.com/logo.png</logo_uri>
      <client_name>GreenEnergy Analytics</client_name>
      <client_uri>https://thirdparty.example.com</client_uri>
      <redirect_uri>https://thirdparty.example.com/espi/1_1/OAuthCallBack</redirect_uri>
      <client_id>third_party_247931</client_id>
      <tos_uri>https://thirdparty.example.com/tos</tos_uri>
      <policy_uri>https://thirdparty.example.com/privacy</policy_uri>
      <software_id>GreenEnergy_Analytics</software_id>
      <software_version>2.1.0</software_version>
      <client_id_issued_at>1697823155</client_id_issued_at>
      <client_secret_expires_at>0</client_secret_expires_at>
      <contacts>admin@thirdparty.example.com</contacts>
      <token_endpoint_auth_method>client_secret_basic</token_endpoint_auth_method>
      <scope>FB=1_3_4_5_8_13_14_15_18_19_31_32_33_34_35_37_39;IntervalDuration=900;BlockDuration=monthly;HistoryLength=13</scope>
      <grant_types>authorization_code</grant_types>
      <grant_types>client_credentials</grant_types>
      <grant_types>refresh_token</grant_types>
      <response_types>code</response_types>
      <registration_client_uri>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ApplicationInformation/247931</registration_client_uri>
      <registration_access_token>reg_token_d4e5f6a7b8c9</registration_access_token>
    </ApplicationInformation>
  </content>
</entry>

Authorization

Operations for managing OAuth 2.0 authorizations that grant Third Party Applications access to energy usage data.

Retrieve all Authorizations [FB_3]

Returns an Atom feed containing all Authorization resources. Requires a valid data_custodian_access_token or client_access_token.

Authorizations:

oauth2

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:9d4a2e71-6b83-5f02-a1c5-3e7f8d9a0b12</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Authorization" type="espi-feed/Authorization"/>
  <title>Authorization</title>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <entry>
    <id>urn:uuid:b3c7d1e5-4a98-5f26-8b03-1d5e7f9a2c46</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Authorization/407593" type="espi-entry/Authorization"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Authorization" type="espi-feed/Authorization"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>Authorization</title>
    <content>
      <Authorization xmlns="http://naesb.org/espi">
        <authorizedPeriod>
          <duration>31536000</duration>
          <start>1697823155</start>
        </authorizedPeriod>
        <publishedPeriod>
          <duration>31536000</duration>
          <start>1697823155</start>
        </publishedPeriod>
        <status>1</status>
        <expires_at>1729359155</expires_at>
        <grant_type>authorization_code</grant_type>
        <scope>FB=1_3_4_5_8_13_14_15_18_19_31_32_33_34_35_37_39;IntervalDuration=900;BlockDuration=monthly;HistoryLength=13</scope>
        <token_type>Bearer</token_type>
        <resourceURI>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593</resourceURI>
        <authorizationURI>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Authorization/407593</authorizationURI>
        <customerResourceURI>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Batch/RetailCustomer/618934/UsagePoint</customerResourceURI>
      </Authorization>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:e8f2a6d4-5c17-5b39-9e04-8a3d6f1c7e52</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Authorization/407594" type="espi-entry/Authorization"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Authorization" type="espi-feed/Authorization"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>Authorization</title>
    <content>
      <Authorization xmlns="http://naesb.org/espi">
        <authorizedPeriod>
          <duration>31536000</duration>
          <start>1697823155</start>
        </authorizedPeriod>
        <publishedPeriod>
          <duration>31536000</duration>
          <start>1697823155</start>
        </publishedPeriod>
        <status>0</status>
        <expires_at>1729359155</expires_at>
        <grant_type>authorization_code</grant_type>
        <scope>FB=1_3_4_5_8_13_14_15_18_19_31_32_33_34_35_37_39;IntervalDuration=3600;BlockDuration=daily;HistoryLength=13</scope>
        <token_type>Bearer</token_type>
        <resourceURI>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407594</resourceURI>
        <authorizationURI>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Authorization/407594</authorizationURI>
        <customerResourceURI>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Batch/RetailCustomer/618935/UsagePoint</customerResourceURI>
      </Authorization>
    </content>
  </entry>
</feed>

Retrieve an Authorization by its ID [FB_3]

Returns an Atom entry containing the Authorization resource identified by the given ID. Requires a valid data_custodian_access_token or client_access_token.

Authorizations:

oauth2

path Parameters

authorizationId

required

string

ID of the Authorization to be retrieved.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:b3c7d1e5-4a98-5f26-8b03-1d5e7f9a2c46</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Authorization/407593" type="espi-entry/Authorization"/>
  <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Authorization" type="espi-feed/Authorization"/>
  <published>2023-10-20T17:32:35.448812Z</published>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <title>Authorization</title>
  <content>
    <Authorization xmlns="http://naesb.org/espi">
      <authorizedPeriod>
        <duration>31536000</duration>
        <start>1697823155</start>
      </authorizedPeriod>
      <publishedPeriod>
        <duration>31536000</duration>
        <start>1697823155</start>
      </publishedPeriod>
      <status>1</status>
      <expires_at>1729359155</expires_at>
      <grant_type>authorization_code</grant_type>
      <scope>FB=1_3_4_5_8_13_14_15_18_19_31_32_33_34_35_37_39;IntervalDuration=900;BlockDuration=monthly;HistoryLength=13</scope>
      <token_type>Bearer</token_type>
      <resourceURI>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593</resourceURI>
      <authorizationURI>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Authorization/407593</authorizationURI>
      <customerResourceURI>https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Batch/RetailCustomer/618934/UsagePoint</customerResourceURI>
    </Authorization>
  </content>
</entry>

Batch

Batch operations for bulk data transfer, subscription feeds, and Green Button Download My Data / Connect My Data flows.

Request a Bulk transfer from a DataCustodian [FB_35]

Initiates a bulk data transfer. Returns an Atom feed containing all resources associated with the specified Bulk ID. Requires a valid data_custodian_access_token or client_access_token.

Authorizations:

oauth2

path Parameters

bulkId

required

string

The Bulk ID as specified in the OAuth2 SCOPE string.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

Example

A complete Subscription feed with UsagePoint, LocalTimeParameters, MeterReading, ReadingType, and IntervalBlock entries

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:abf12767-5352-5615-b41a-fef23ba42bad</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Batch/Subscription/407593" type="espi-feed/Subscription"/>
  <link rel="related" href="https://cert.greenbuttonalliance.org/certificate/26b96996-d393-5e95-b78d-9419f3080469" type="text/html"/>
  <title>Subscription</title>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <entry>
    <id>urn:uuid:e6896122-a094-5d30-be14-e44544247e14</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint" type="espi-feed/UsagePoint"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary" type="espi-feed/UsageSummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary" type="espi-feed/ElectricPowerQualitySummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>UsagePoint</title>
    <content>
      <UsagePoint xmlns="http://naesb.org/espi">
        <ServiceCategory>
          <kind>0</kind>
        </ServiceCategory>
      </UsagePoint>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:305129b8-503c-5b50-b293-333cd7fb6adf</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters" type="espi-feed/LocalTimeParameters"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>LocalTimeParameters</title>
    <content>
      <LocalTimeParameters xmlns="http://naesb.org/espi">
        <dstEndRule>B40E2000</dstEndRule>
        <dstOffset>3600</dstOffset>
        <dstStartRule>360E2000</dstStartRule>
        <tzOffset>-18000</tzOffset>
      </LocalTimeParameters>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:6052217b-aadf-5cca-b803-c611f9fcf89e</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-entry/MeterReading"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>MeterReading</title>
    <content>
      <MeterReading xmlns="http://naesb.org/espi"/>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:06ff0942-04fc-5f91-bc35-ca5e51b49dbb</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType" type="espi-feed/ReadingType"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>ReadingType</title>
    <content>
      <ReadingType xmlns="http://naesb.org/espi">
        <accumulationBehaviour>1</accumulationBehaviour>
        <commodity>1</commodity>
        <currency>840</currency>
        <flowDirection>1</flowDirection>
        <intervalLength>2332800</intervalLength>
        <kind>12</kind>
        <phase>0</phase>
        <powerOfTenMultiplier>-3</powerOfTenMultiplier>
        <uom>72</uom>
      </ReadingType>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:1e530409-5dbe-572f-aad8-fa06f6a68cfc</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock/000001" type="espi-entry/IntervalBlock"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-feed/MeterReading"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>IntervalBlock</title>
    <content>
      <IntervalBlock xmlns="http://naesb.org/espi">
        <interval>
          <duration>2332800</duration>
          <start>1663992000</start>
        </interval>
        <IntervalReading>
          <cost>115780000</cost>
          <timePeriod>
            <duration>2332800</duration>
            <start>1663992000</start>
          </timePeriod>
          <value>1330890000</value>
        </IntervalReading>
      </IntervalBlock>
    </content>
  </entry>
</feed>

Request a Green Button Subscription from a DataCustodian [FB_3]

Returns an Atom feed containing all resources associated with the specified Subscription. This is the Connect My Data feed endpoint. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

subscriptionId

required

string

The Subscription's ID.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

Example

A complete Subscription feed with UsagePoint, LocalTimeParameters, MeterReading, ReadingType, and IntervalBlock entries

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:abf12767-5352-5615-b41a-fef23ba42bad</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Batch/Subscription/407593" type="espi-feed/Subscription"/>
  <link rel="related" href="https://cert.greenbuttonalliance.org/certificate/26b96996-d393-5e95-b78d-9419f3080469" type="text/html"/>
  <title>Subscription</title>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <entry>
    <id>urn:uuid:e6896122-a094-5d30-be14-e44544247e14</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint" type="espi-feed/UsagePoint"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary" type="espi-feed/UsageSummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary" type="espi-feed/ElectricPowerQualitySummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>UsagePoint</title>
    <content>
      <UsagePoint xmlns="http://naesb.org/espi">
        <ServiceCategory>
          <kind>0</kind>
        </ServiceCategory>
      </UsagePoint>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:305129b8-503c-5b50-b293-333cd7fb6adf</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters" type="espi-feed/LocalTimeParameters"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>LocalTimeParameters</title>
    <content>
      <LocalTimeParameters xmlns="http://naesb.org/espi">
        <dstEndRule>B40E2000</dstEndRule>
        <dstOffset>3600</dstOffset>
        <dstStartRule>360E2000</dstStartRule>
        <tzOffset>-18000</tzOffset>
      </LocalTimeParameters>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:6052217b-aadf-5cca-b803-c611f9fcf89e</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-entry/MeterReading"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>MeterReading</title>
    <content>
      <MeterReading xmlns="http://naesb.org/espi"/>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:06ff0942-04fc-5f91-bc35-ca5e51b49dbb</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType" type="espi-feed/ReadingType"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>ReadingType</title>
    <content>
      <ReadingType xmlns="http://naesb.org/espi">
        <accumulationBehaviour>1</accumulationBehaviour>
        <commodity>1</commodity>
        <currency>840</currency>
        <flowDirection>1</flowDirection>
        <intervalLength>2332800</intervalLength>
        <kind>12</kind>
        <phase>0</phase>
        <powerOfTenMultiplier>-3</powerOfTenMultiplier>
        <uom>72</uom>
      </ReadingType>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:1e530409-5dbe-572f-aad8-fa06f6a68cfc</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock/000001" type="espi-entry/IntervalBlock"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-feed/MeterReading"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>IntervalBlock</title>
    <content>
      <IntervalBlock xmlns="http://naesb.org/espi">
        <interval>
          <duration>2332800</duration>
          <start>1663992000</start>
        </interval>
        <IntervalReading>
          <cost>115780000</cost>
          <timePeriod>
            <duration>2332800</duration>
            <start>1663992000</start>
          </timePeriod>
          <value>1330890000</value>
        </IntervalReading>
      </IntervalBlock>
    </content>
  </entry>
</feed>

Download a Green Button XML file for a RetailCustomer [FB_33]

Downloads a Green Button XML file containing UsagePoint data for the specified Retail Customer. This is the Download My Data endpoint. Requires a valid data_custodian_access_token or upload_access_token.

Authorizations:

oauth2

path Parameters

retailCustomerId

required

string

The Retail Customer's ID.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

Example

A complete Subscription feed with UsagePoint, LocalTimeParameters, MeterReading, ReadingType, and IntervalBlock entries

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:abf12767-5352-5615-b41a-fef23ba42bad</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Batch/Subscription/407593" type="espi-feed/Subscription"/>
  <link rel="related" href="https://cert.greenbuttonalliance.org/certificate/26b96996-d393-5e95-b78d-9419f3080469" type="text/html"/>
  <title>Subscription</title>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <entry>
    <id>urn:uuid:e6896122-a094-5d30-be14-e44544247e14</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint" type="espi-feed/UsagePoint"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary" type="espi-feed/UsageSummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary" type="espi-feed/ElectricPowerQualitySummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>UsagePoint</title>
    <content>
      <UsagePoint xmlns="http://naesb.org/espi">
        <ServiceCategory>
          <kind>0</kind>
        </ServiceCategory>
      </UsagePoint>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:305129b8-503c-5b50-b293-333cd7fb6adf</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters" type="espi-feed/LocalTimeParameters"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>LocalTimeParameters</title>
    <content>
      <LocalTimeParameters xmlns="http://naesb.org/espi">
        <dstEndRule>B40E2000</dstEndRule>
        <dstOffset>3600</dstOffset>
        <dstStartRule>360E2000</dstStartRule>
        <tzOffset>-18000</tzOffset>
      </LocalTimeParameters>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:6052217b-aadf-5cca-b803-c611f9fcf89e</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-entry/MeterReading"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>MeterReading</title>
    <content>
      <MeterReading xmlns="http://naesb.org/espi"/>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:06ff0942-04fc-5f91-bc35-ca5e51b49dbb</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType" type="espi-feed/ReadingType"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>ReadingType</title>
    <content>
      <ReadingType xmlns="http://naesb.org/espi">
        <accumulationBehaviour>1</accumulationBehaviour>
        <commodity>1</commodity>
        <currency>840</currency>
        <flowDirection>1</flowDirection>
        <intervalLength>2332800</intervalLength>
        <kind>12</kind>
        <phase>0</phase>
        <powerOfTenMultiplier>-3</powerOfTenMultiplier>
        <uom>72</uom>
      </ReadingType>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:1e530409-5dbe-572f-aad8-fa06f6a68cfc</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock/000001" type="espi-entry/IntervalBlock"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-feed/MeterReading"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>IntervalBlock</title>
    <content>
      <IntervalBlock xmlns="http://naesb.org/espi">
        <interval>
          <duration>2332800</duration>
          <start>1663992000</start>
        </interval>
        <IntervalReading>
          <cost>115780000</cost>
          <timePeriod>
            <duration>2332800</duration>
            <start>1663992000</start>
          </timePeriod>
          <value>1330890000</value>
        </IntervalReading>
      </IntervalBlock>
    </content>
  </entry>
</feed>

Request a Green Button Subscription for a specific UsagePoint [FB_32]

Returns an Atom feed containing all resources associated with the specified Subscription and UsagePoint. This is the Connect My Data feed endpoint scoped to a specific UsagePoint. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

subscriptionId required	string The Subscription's ID.
usagePointId required	string The UsagePoint's ID.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

Example

A complete Subscription feed with UsagePoint, LocalTimeParameters, MeterReading, ReadingType, and IntervalBlock entries

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:abf12767-5352-5615-b41a-fef23ba42bad</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Batch/Subscription/407593" type="espi-feed/Subscription"/>
  <link rel="related" href="https://cert.greenbuttonalliance.org/certificate/26b96996-d393-5e95-b78d-9419f3080469" type="text/html"/>
  <title>Subscription</title>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <entry>
    <id>urn:uuid:e6896122-a094-5d30-be14-e44544247e14</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint" type="espi-feed/UsagePoint"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary" type="espi-feed/UsageSummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary" type="espi-feed/ElectricPowerQualitySummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>UsagePoint</title>
    <content>
      <UsagePoint xmlns="http://naesb.org/espi">
        <ServiceCategory>
          <kind>0</kind>
        </ServiceCategory>
      </UsagePoint>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:305129b8-503c-5b50-b293-333cd7fb6adf</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters" type="espi-feed/LocalTimeParameters"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>LocalTimeParameters</title>
    <content>
      <LocalTimeParameters xmlns="http://naesb.org/espi">
        <dstEndRule>B40E2000</dstEndRule>
        <dstOffset>3600</dstOffset>
        <dstStartRule>360E2000</dstStartRule>
        <tzOffset>-18000</tzOffset>
      </LocalTimeParameters>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:6052217b-aadf-5cca-b803-c611f9fcf89e</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-entry/MeterReading"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>MeterReading</title>
    <content>
      <MeterReading xmlns="http://naesb.org/espi"/>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:06ff0942-04fc-5f91-bc35-ca5e51b49dbb</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType" type="espi-feed/ReadingType"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>ReadingType</title>
    <content>
      <ReadingType xmlns="http://naesb.org/espi">
        <accumulationBehaviour>1</accumulationBehaviour>
        <commodity>1</commodity>
        <currency>840</currency>
        <flowDirection>1</flowDirection>
        <intervalLength>2332800</intervalLength>
        <kind>12</kind>
        <phase>0</phase>
        <powerOfTenMultiplier>-3</powerOfTenMultiplier>
        <uom>72</uom>
      </ReadingType>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:1e530409-5dbe-572f-aad8-fa06f6a68cfc</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock/000001" type="espi-entry/IntervalBlock"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-feed/MeterReading"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>IntervalBlock</title>
    <content>
      <IntervalBlock xmlns="http://naesb.org/espi">
        <interval>
          <duration>2332800</duration>
          <start>1663992000</start>
        </interval>
        <IntervalReading>
          <cost>115780000</cost>
          <timePeriod>
            <duration>2332800</duration>
            <start>1663992000</start>
          </timePeriod>
          <value>1330890000</value>
        </IntervalReading>
      </IntervalBlock>
    </content>
  </entry>
</feed>

UsagePoint

Operations for accessing Usage Points, which represent logical points on the network where energy consumption or production is measured.

Retrieve all Usage Points [FB_33]

Returns an Atom feed containing all Usage Points within the Data Custodian. Requires a valid data_custodian_access_token.

Authorizations:

oauth2

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:abf12767-5352-5615-b41a-fef23ba42bad</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint" type="espi-feed/UsagePoint"/>
  <title>UsagePoint</title>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <entry>
    <id>urn:uuid:e6896122-a094-5d30-be14-e44544247e14</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint" type="espi-feed/UsagePoint"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary" type="espi-feed/UsageSummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary" type="espi-feed/ElectricPowerQualitySummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>UsagePoint</title>
    <content>
      <UsagePoint xmlns="http://naesb.org/espi">
        <ServiceCategory>
          <kind>0</kind>
        </ServiceCategory>
      </UsagePoint>
    </content>
  </entry>
</feed>

Retrieve a Usage Point by its ID [FB_32]

Returns an Atom entry containing the Usage Point identified by the given ID. Requires a valid data_custodian_access_token.

Authorizations:

oauth2

path Parameters

usagePointId

required

string

ID of the Usage Point.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:e6896122-a094-5d30-be14-e44544247e14</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
  <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint" type="espi-feed/UsagePoint"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary" type="espi-feed/UsageSummary"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary" type="espi-feed/ElectricPowerQualitySummary"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
  <published>2023-10-20T17:32:35.448812Z</published>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <title>UsagePoint</title>
  <content>
    <UsagePoint xmlns="http://naesb.org/espi">
      <ServiceCategory>
        <kind>0</kind>
      </ServiceCategory>
    </UsagePoint>
  </content>
</entry>

Retrieve all Usage Points by Subscription ID [FB_32]

Returns an Atom feed containing all Usage Points associated with the specified Subscription. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

subscriptionId

required

string

The Subscription's ID.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:abf12767-5352-5615-b41a-fef23ba42bad</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint" type="espi-feed/UsagePoint"/>
  <title>UsagePoint</title>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <entry>
    <id>urn:uuid:e6896122-a094-5d30-be14-e44544247e14</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint" type="espi-feed/UsagePoint"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary" type="espi-feed/UsageSummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary" type="espi-feed/ElectricPowerQualitySummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>UsagePoint</title>
    <content>
      <UsagePoint xmlns="http://naesb.org/espi">
        <ServiceCategory>
          <kind>0</kind>
        </ServiceCategory>
      </UsagePoint>
    </content>
  </entry>
</feed>

Retrieve a Subscription Usage Point by its ID [FB_32]

Returns an Atom entry containing the Usage Point identified by the given ID within the specified Subscription. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

subscriptionId required	string The Subscription's ID.
usagePointId required	string ID of the Usage Point.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:e6896122-a094-5d30-be14-e44544247e14</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
  <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint" type="espi-feed/UsagePoint"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary" type="espi-feed/UsageSummary"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary" type="espi-feed/ElectricPowerQualitySummary"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
  <published>2023-10-20T17:32:35.448812Z</published>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <title>UsagePoint</title>
  <content>
    <UsagePoint xmlns="http://naesb.org/espi">
      <ServiceCategory>
        <kind>0</kind>
      </ServiceCategory>
    </UsagePoint>
  </content>
</entry>

MeterReading

Operations for accessing Meter Readings, which represent sets of values obtained from a meter.

Retrieve all Meter Readings within the Data Custodian [FB_33]

Returns an Atom feed containing all Meter Readings. Requires a valid data_custodian_access_token.

Authorizations:

oauth2

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:2e4f6a8c-0b1d-5e3f-5a7b-9c0d1e2f3a4b</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
  <title>MeterReading</title>
  <updated>2023-10-20T17:32:44.801089Z</updated>
  <entry>
    <id>urn:uuid:6052217b-aadf-5cca-b803-c611f9fcf89e</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-entry/MeterReading"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>MeterReading</title>
    <content>
      <MeterReading xmlns="http://naesb.org/espi"/>
    </content>
  </entry>
</feed>

Retrieve a Meter Reading by its ID [FB_33]

Returns an Atom entry containing the Meter Reading identified by the given ID. Requires a valid data_custodian_access_token.

Authorizations:

oauth2

path Parameters

meterReadingId

required

string

ID of the Meter Reading.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:6052217b-aadf-5cca-b803-c611f9fcf89e</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-entry/MeterReading"/>
  <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
  <published>2023-10-20T17:32:44.801089Z</published>
  <updated>2023-10-20T17:32:44.801089Z</updated>
  <title>MeterReading</title>
  <content>
    <MeterReading xmlns="http://naesb.org/espi"/>
  </content>
</entry>

Retrieve all Meter Readings for a Usage Point [FB_32]

Returns an Atom feed containing all Meter Readings associated with the specified Usage Point within the Subscription. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

subscriptionId required	string ID of the Subscription.
usagePointId required	string ID of the UsagePoint the Meter Reading references.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:2e4f6a8c-0b1d-5e3f-5a7b-9c0d1e2f3a4b</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
  <title>MeterReading</title>
  <updated>2023-10-20T17:32:44.801089Z</updated>
  <entry>
    <id>urn:uuid:6052217b-aadf-5cca-b803-c611f9fcf89e</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-entry/MeterReading"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>MeterReading</title>
    <content>
      <MeterReading xmlns="http://naesb.org/espi"/>
    </content>
  </entry>
</feed>

Retrieve a Meter Reading by its ID within a Subscription [FB_32]

Returns an Atom entry containing the Meter Reading identified by the given ID, within the specified Subscription and Usage Point. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

subscriptionId required	string ID of the Subscription.
usagePointId required	string ID of the UsagePoint the Meter Reading references.
meterReadingId required	string ID of the Meter Reading.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:6052217b-aadf-5cca-b803-c611f9fcf89e</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-entry/MeterReading"/>
  <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading" type="espi-feed/MeterReading"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
  <published>2023-10-20T17:32:44.801089Z</published>
  <updated>2023-10-20T17:32:44.801089Z</updated>
  <title>MeterReading</title>
  <content>
    <MeterReading xmlns="http://naesb.org/espi"/>
  </content>
</entry>

IntervalBlock

Operations for accessing Interval Blocks, which contain time sequences of interval readings for a specific ReadingType.

Retrieve all Interval Blocks [FB_33]

Returns an Atom feed containing all Interval Blocks within the Data Custodian. Requires a valid data_custodian_access_token.

Authorizations:

oauth2

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:abf12767-5352-5615-b41a-fef23ba42bad</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
  <title>IntervalBlock</title>
  <updated>2023-10-20T17:32:44.801089Z</updated>
  <entry>
    <id>urn:uuid:1e530409-5dbe-572f-aad8-fa06f6a68cfc</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock/000001" type="espi-entry/IntervalBlock"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-feed/MeterReading"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>IntervalBlock</title>
    <content>
      <IntervalBlock xmlns="http://naesb.org/espi">
        <interval>
          <duration>2332800</duration>
          <start>1663992000</start>
        </interval>
        <IntervalReading>
          <cost>115780000</cost>
          <timePeriod>
            <duration>2332800</duration>
            <start>1663992000</start>
          </timePeriod>
          <value>1330890000</value>
        </IntervalReading>
      </IntervalBlock>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:0de5026c-9497-5712-99b0-9790101aee1b</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020674_kwh_1/IntervalBlock/000001" type="espi-entry/IntervalBlock"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020674_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020674_kwh_1" type="espi-feed/MeterReading"/>
    <published>2023-10-20T17:32:44.814423Z</published>
    <updated>2023-10-20T17:32:44.814423Z</updated>
    <title>IntervalBlock</title>
    <content>
      <IntervalBlock xmlns="http://naesb.org/espi">
        <interval>
          <duration>2768400</duration>
          <start>1666411200</start>
        </interval>
        <IntervalReading>
          <cost>107994000</cost>
          <timePeriod>
            <duration>2768400</duration>
            <start>1666411200</start>
          </timePeriod>
          <value>1673810000</value>
        </IntervalReading>
      </IntervalBlock>
    </content>
  </entry>
</feed>

Retrieve an Interval Block by its ID [FB_33]

Returns an Atom entry containing the Interval Block identified by the given ID. Requires a valid data_custodian_access_token.

Authorizations:

oauth2

path Parameters

intervalBlockId

required

string

ID of the Interval Block to be retrieved.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:1e530409-5dbe-572f-aad8-fa06f6a68cfc</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock/000001" type="espi-entry/IntervalBlock"/>
  <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-feed/MeterReading"/>
  <published>2023-10-20T17:32:44.801089Z</published>
  <updated>2023-10-20T17:32:44.801089Z</updated>
  <title>IntervalBlock</title>
  <content>
    <IntervalBlock xmlns="http://naesb.org/espi">
      <interval>
        <duration>2332800</duration>
        <start>1663992000</start>
      </interval>
      <IntervalReading>
        <cost>115780000</cost>
        <timePeriod>
          <duration>2332800</duration>
          <start>1663992000</start>
        </timePeriod>
        <value>1330890000</value>
      </IntervalReading>
    </IntervalBlock>
  </content>
</entry>

Retrieve all Interval Blocks for a Meter Reading [FB_32]

Returns an Atom feed containing all Interval Blocks associated with the specified Meter Reading within the Subscription. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

subscriptionId required	string ID of the Subscription.
usagePointId required	string ID of the UsagePoint the Interval Block references.
meterReadingId required	string ID of the MeterReading the Interval Block references.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:abf12767-5352-5615-b41a-fef23ba42bad</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
  <title>IntervalBlock</title>
  <updated>2023-10-20T17:32:44.801089Z</updated>
  <entry>
    <id>urn:uuid:1e530409-5dbe-572f-aad8-fa06f6a68cfc</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock/000001" type="espi-entry/IntervalBlock"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-feed/MeterReading"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>IntervalBlock</title>
    <content>
      <IntervalBlock xmlns="http://naesb.org/espi">
        <interval>
          <duration>2332800</duration>
          <start>1663992000</start>
        </interval>
        <IntervalReading>
          <cost>115780000</cost>
          <timePeriod>
            <duration>2332800</duration>
            <start>1663992000</start>
          </timePeriod>
          <value>1330890000</value>
        </IntervalReading>
      </IntervalBlock>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:0de5026c-9497-5712-99b0-9790101aee1b</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020674_kwh_1/IntervalBlock/000001" type="espi-entry/IntervalBlock"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020674_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020674_kwh_1" type="espi-feed/MeterReading"/>
    <published>2023-10-20T17:32:44.814423Z</published>
    <updated>2023-10-20T17:32:44.814423Z</updated>
    <title>IntervalBlock</title>
    <content>
      <IntervalBlock xmlns="http://naesb.org/espi">
        <interval>
          <duration>2768400</duration>
          <start>1666411200</start>
        </interval>
        <IntervalReading>
          <cost>107994000</cost>
          <timePeriod>
            <duration>2768400</duration>
            <start>1666411200</start>
          </timePeriod>
          <value>1673810000</value>
        </IntervalReading>
      </IntervalBlock>
    </content>
  </entry>
</feed>

Retrieve an Interval Block by its ID within a Subscription [FB_32]

Returns an Atom entry containing the Interval Block identified by the given ID, within the specified Subscription, Usage Point, and Meter Reading hierarchy. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

subscriptionId required	string ID of the Subscription.
usagePointId required	string ID of the UsagePoint the Interval Block references.
meterReadingId required	string ID of the MeterReading the Interval Block references.
intervalBlockId required	string ID of the Interval Block to be retrieved.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:1e530409-5dbe-572f-aad8-fa06f6a68cfc</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock/000001" type="espi-entry/IntervalBlock"/>
  <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1/IntervalBlock" type="espi-feed/IntervalBlock"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/MeterReading/Ba020673_kwh_1" type="espi-feed/MeterReading"/>
  <published>2023-10-20T17:32:44.801089Z</published>
  <updated>2023-10-20T17:32:44.801089Z</updated>
  <title>IntervalBlock</title>
  <content>
    <IntervalBlock xmlns="http://naesb.org/espi">
      <interval>
        <duration>2332800</duration>
        <start>1663992000</start>
      </interval>
      <IntervalReading>
        <cost>115780000</cost>
        <timePeriod>
          <duration>2332800</duration>
          <start>1663992000</start>
        </timePeriod>
        <value>1330890000</value>
      </IntervalReading>
    </IntervalBlock>
  </content>
</entry>

ReadingType

Operations for accessing Reading Types, which describe the characteristics of meter readings.

Retrieve all Reading Types [FB_32]

Returns an Atom feed containing all Reading Types. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:3f5a7b9c-1d2e-5f40-6b8c-0d1e2f3a4b5c</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType" type="espi-feed/ReadingType"/>
  <title>ReadingType</title>
  <updated>2023-10-20T17:32:44.801089Z</updated>
  <entry>
    <id>urn:uuid:06ff0942-04fc-5f91-bc35-ca5e51b49dbb</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType" type="espi-feed/ReadingType"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>ReadingType</title>
    <content>
      <ReadingType xmlns="http://naesb.org/espi">
        <accumulationBehaviour>1</accumulationBehaviour>
        <commodity>1</commodity>
        <currency>840</currency>
        <flowDirection>1</flowDirection>
        <intervalLength>2332800</intervalLength>
        <kind>12</kind>
        <phase>0</phase>
        <powerOfTenMultiplier>-3</powerOfTenMultiplier>
        <uom>72</uom>
      </ReadingType>
    </content>
  </entry>
</feed>

Retrieve a Reading Type by its ID [FB_32]

Returns an Atom entry containing the Reading Type identified by the given ID. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

readingTypeId

required

string

ID of the Reading Type.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:06ff0942-04fc-5f91-bc35-ca5e51b49dbb</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType/407593_1455246_Ba020673_kwh_1" type="espi-entry/ReadingType"/>
  <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/ReadingType" type="espi-feed/ReadingType"/>
  <published>2023-10-20T17:32:44.801089Z</published>
  <updated>2023-10-20T17:32:44.801089Z</updated>
  <title>ReadingType</title>
  <content>
    <ReadingType xmlns="http://naesb.org/espi">
      <accumulationBehaviour>1</accumulationBehaviour>
      <commodity>1</commodity>
      <currency>840</currency>
      <flowDirection>1</flowDirection>
      <intervalLength>2332800</intervalLength>
      <kind>12</kind>
      <phase>0</phase>
      <powerOfTenMultiplier>-3</powerOfTenMultiplier>
      <uom>72</uom>
    </ReadingType>
  </content>
</entry>

ElectricPowerQualitySummary

Operations for accessing Electric Power Quality Summaries, which provide power quality event information.

Retrieve all Electric Power Quality Summaries [FB_32]

Returns an Atom feed containing all Electric Power Quality Summaries associated with the specified Usage Point within the Subscription. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

subscriptionId required	string The Subscription's ID.
usagePointId required	string ID of the UsagePoint the Electric Power Quality Summary references.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:a1b2c3d4-5e6f-5708-9a1b-2c3d4e5f6a7b</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary" type="espi-feed/ElectricPowerQualitySummary"/>
  <title>ElectricPowerQualitySummary</title>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <entry>
    <id>urn:uuid:d4e5f6a7-b8c9-5d01-e2f3-a4b5c6d7e8f9</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary/328475" type="espi-entry/ElectricPowerQualitySummary"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary" type="espi-feed/ElectricPowerQualitySummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>ElectricPowerQualitySummary</title>
    <content>
      <ElectricPowerQualitySummary xmlns="http://naesb.org/espi">
        <flickerPlt>1</flickerPlt>
        <flickerPst>2</flickerPst>
        <harmonicVoltage>3</harmonicVoltage>
        <longInterruptions>0</longInterruptions>
        <mainsVoltage>240100</mainsVoltage>
        <measurementProtocol>2</measurementProtocol>
        <powerFrequency>600</powerFrequency>
        <rapidVoltageChanges>0</rapidVoltageChanges>
        <shortInterruptions>2</shortInterruptions>
        <summaryInterval>
          <duration>2592000</duration>
          <start>1693540800</start>
        </summaryInterval>
        <supplyVoltageDips>1</supplyVoltageDips>
        <supplyVoltageImbalance>0</supplyVoltageImbalance>
        <supplyVoltageVariations>3</supplyVoltageVariations>
        <tempOvervoltage>0</tempOvervoltage>
      </ElectricPowerQualitySummary>
    </content>
  </entry>
</feed>

Retrieve an Electric Power Quality Summary by its ID [FB_32]

Returns an Atom entry containing the Electric Power Quality Summary identified by the given ID. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

subscriptionId required	string The Subscription's ID.
usagePointId required	string ID of the Usage Point the Electric Power Quality Summary references.
electricPowerQualitySummaryId required	string ID of the Electric Power Quality Summary to be retrieved.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:d4e5f6a7-b8c9-5d01-e2f3-a4b5c6d7e8f9</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary/328475" type="espi-entry/ElectricPowerQualitySummary"/>
  <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/ElectricPowerQualitySummary" type="espi-feed/ElectricPowerQualitySummary"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
  <published>2023-10-20T17:32:35.448812Z</published>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <title>ElectricPowerQualitySummary</title>
  <content>
    <ElectricPowerQualitySummary xmlns="http://naesb.org/espi">
      <flickerPlt>1</flickerPlt>
      <flickerPst>2</flickerPst>
      <harmonicVoltage>3</harmonicVoltage>
      <longInterruptions>0</longInterruptions>
      <mainsVoltage>240100</mainsVoltage>
      <measurementProtocol>2</measurementProtocol>
      <powerFrequency>600</powerFrequency>
      <rapidVoltageChanges>0</rapidVoltageChanges>
      <shortInterruptions>2</shortInterruptions>
      <summaryInterval>
        <duration>2592000</duration>
        <start>1693540800</start>
      </summaryInterval>
      <supplyVoltageDips>1</supplyVoltageDips>
      <supplyVoltageImbalance>0</supplyVoltageImbalance>
      <supplyVoltageVariations>3</supplyVoltageVariations>
      <tempOvervoltage>0</tempOvervoltage>
    </ElectricPowerQualitySummary>
  </content>
</entry>

UsageSummary

Operations for accessing Usage Summaries, which provide aggregated usage and billing information for specific time periods.

Retrieve all Usage Summaries [FB_32]

Returns an Atom feed containing all Usage Summaries associated with the specified Usage Point within the Subscription. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

subscriptionId required	string The Subscription's ID.
usagePointId required	string ID of the UsagePoint the Usage Summary references.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:c2d3e4f5-6a7b-5809-1c2d-3e4f5a6b7c8d</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary" type="espi-feed/UsageSummary"/>
  <title>UsageSummary</title>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <entry>
    <id>urn:uuid:f1e2d3c4-b5a6-5978-8190-a2b3c4d5e6f7</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary/539217" type="espi-entry/UsageSummary"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary" type="espi-feed/UsageSummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>UsageSummary</title>
    <content>
      <UsageSummary xmlns="http://naesb.org/espi">
        <billingPeriod>
          <duration>2592000</duration>
          <start>1693540800</start>
        </billingPeriod>
        <billLastPeriod>11578000</billLastPeriod>
        <billToDate>8934000</billToDate>
        <costAdditionalLastPeriod>150000</costAdditionalLastPeriod>
        <currency>840</currency>
        <overallConsumptionLastPeriod>
          <powerOfTenMultiplier>-3</powerOfTenMultiplier>
          <uom>72</uom>
          <value>1330890000</value>
        </overallConsumptionLastPeriod>
        <currentBillingPeriodOverAllConsumption>
          <powerOfTenMultiplier>-3</powerOfTenMultiplier>
          <timeStamp>1696132800</timeStamp>
          <uom>72</uom>
          <value>987654000</value>
        </currentBillingPeriodOverAllConsumption>
        <qualityOfReading>14</qualityOfReading>
        <statusTimeStamp>1697823203</statusTimeStamp>
        <commodity>1</commodity>
        <tariffProfile>Standard Residential</tariffProfile>
        <readCycle>15</readCycle>
      </UsageSummary>
    </content>
  </entry>
  <entry>
    <id>urn:uuid:a8b9c0d1-e2f3-5a45-6b7c-8d9e0f1a2b3c</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary/539218" type="espi-entry/UsageSummary"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary" type="espi-feed/UsageSummary"/>
    <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
    <published>2023-10-20T17:32:44.801089Z</published>
    <updated>2023-10-20T17:32:44.801089Z</updated>
    <title>UsageSummary</title>
    <content>
      <UsageSummary xmlns="http://naesb.org/espi">
        <billingPeriod>
          <duration>2678400</duration>
          <start>1696132800</start>
        </billingPeriod>
        <billLastPeriod>8934000</billLastPeriod>
        <billToDate>10245000</billToDate>
        <costAdditionalLastPeriod>125000</costAdditionalLastPeriod>
        <currency>840</currency>
        <overallConsumptionLastPeriod>
          <powerOfTenMultiplier>-3</powerOfTenMultiplier>
          <uom>72</uom>
          <value>987654000</value>
        </overallConsumptionLastPeriod>
        <currentBillingPeriodOverAllConsumption>
          <powerOfTenMultiplier>-3</powerOfTenMultiplier>
          <timeStamp>1698811200</timeStamp>
          <uom>72</uom>
          <value>1102345000</value>
        </currentBillingPeriodOverAllConsumption>
        <qualityOfReading>14</qualityOfReading>
        <statusTimeStamp>1697823203</statusTimeStamp>
        <commodity>1</commodity>
        <tariffProfile>Standard Residential</tariffProfile>
        <readCycle>15</readCycle>
      </UsageSummary>
    </content>
  </entry>
</feed>

Retrieve a Usage Summary by its ID [FB_32]

Returns an Atom entry containing the Usage Summary identified by the given ID. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

subscriptionId required	string The Subscription's ID.
usagePointId required	string ID of the UsagePoint the Usage Summary references.
usageSummaryId required	string ID of the Usage Summary to be retrieved.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:f1e2d3c4-b5a6-5978-8190-a2b3c4d5e6f7</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary/539217" type="espi-entry/UsageSummary"/>
  <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246/UsageSummary" type="espi-feed/UsageSummary"/>
  <link rel="related" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/Subscription/407593/UsagePoint/1455246" type="espi-entry/UsagePoint"/>
  <published>2023-10-20T17:32:35.448812Z</published>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <title>UsageSummary</title>
  <content>
    <UsageSummary xmlns="http://naesb.org/espi">
      <billingPeriod>
        <duration>2592000</duration>
        <start>1693540800</start>
      </billingPeriod>
      <billLastPeriod>11578000</billLastPeriod>
      <billToDate>8934000</billToDate>
      <costAdditionalLastPeriod>150000</costAdditionalLastPeriod>
      <currency>840</currency>
      <overallConsumptionLastPeriod>
        <powerOfTenMultiplier>-3</powerOfTenMultiplier>
        <uom>72</uom>
        <value>1330890000</value>
      </overallConsumptionLastPeriod>
      <currentBillingPeriodOverAllConsumption>
        <powerOfTenMultiplier>-3</powerOfTenMultiplier>
        <timeStamp>1696132800</timeStamp>
        <uom>72</uom>
        <value>987654000</value>
      </currentBillingPeriodOverAllConsumption>
      <qualityOfReading>14</qualityOfReading>
      <statusTimeStamp>1697823203</statusTimeStamp>
      <commodity>1</commodity>
      <tariffProfile>Standard Residential</tariffProfile>
      <readCycle>15</readCycle>
    </UsageSummary>
  </content>
</entry>

LocalTimeParameters

Operations for accessing Local Time Parameters, which describe timezone and daylight savings time configuration.

Retrieve all Local Time Parameters [FB_32]

Returns an Atom feed containing all Local Time Parameters. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:4a6b8c0d-2e3f-5a51-7b9c-1d2e3f4a5b6c</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters" type="espi-feed/LocalTimeParameters"/>
  <title>LocalTimeParameters</title>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <entry>
    <id>urn:uuid:305129b8-503c-5b50-b293-333cd7fb6adf</id>
    <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
    <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters" type="espi-feed/LocalTimeParameters"/>
    <published>2023-10-20T17:32:35.448812Z</published>
    <updated>2023-10-20T17:33:23.054424Z</updated>
    <title>LocalTimeParameters</title>
    <content>
      <LocalTimeParameters xmlns="http://naesb.org/espi">
        <dstEndRule>B40E2000</dstEndRule>
        <dstOffset>3600</dstOffset>
        <dstStartRule>360E2000</dstStartRule>
        <tzOffset>-18000</tzOffset>
      </LocalTimeParameters>
    </content>
  </entry>
</feed>

Retrieve a Local Time Parameter by its ID [FB_32]

Returns an Atom entry containing the Local Time Parameter identified by the given ID. Requires a valid data_custodian_access_token or access_token.

Authorizations:

oauth2

path Parameters

localTimeParameterId

required

string

ID of the Local Time Parameter.

query Parameters

published-max	string <date-time> The upper bound on the published date of the resource.
published-min	string <date-time> The lower bound on the published date of the resource.
updated-max	string <date-time> The upper bound on the updated date of the resource.
updated-min	string <date-time> The lower bound on the updated date of the resource.
max-results	integer <int64> The upper bound on the number of entries to be contained in the response.
start-index	integer <int64> The one-based offset in the DataCustodian's collection of resources that should be transferred as the first entry of the response.
depth	integer <int64> The maximum number of entries to be transferred in the response.

Responses

Response samples

200

Content type

application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:305129b8-503c-5b50-b293-333cd7fb6adf</id>
  <link rel="self" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters/TIMEZONE_407593_1455246" type="espi-entry/LocalTimeParameters"/>
  <link rel="up" href="https://data.greenbuttonconnect.org/DataCustodian/espi/1_1/resource/LocalTimeParameters" type="espi-feed/LocalTimeParameters"/>
  <published>2023-10-20T17:32:35.448812Z</published>
  <updated>2023-10-20T17:33:23.054424Z</updated>
  <title>LocalTimeParameters</title>
  <content>
    <LocalTimeParameters xmlns="http://naesb.org/espi">
      <dstEndRule>B40E2000</dstEndRule>
      <dstOffset>3600</dstOffset>
      <dstStartRule>360E2000</dstStartRule>
      <tzOffset>-18000</tzOffset>
    </LocalTimeParameters>
  </content>
</entry>

ServiceStatus

Operations for checking the current status of the Data Custodian Resource Server.

Obtain the Data Custodian Resource Server's Status [FB_3]

Returns the current status of the Data Custodian Resource Server. Requires a valid data_custodian_access_token, client_access_token, or upload_access_token.

Authorizations:

oauth2

Responses

Response samples

200

Content type

application/atom+xml

Example

Service status indicating the Data Custodian is online

<ServiceStatus xmlns="http://naesb.org/espi">
  <currentStatus>1</currentStatus>
</ServiceStatus>