Web Service Documentation /
Categories /
Meter Services
Meter Services
The Meter Services allow you to manage meters within Portfolio Manager. These services support all meter categories: all fuels, water, Data Center IT energy meters, waste, and water and wastewater plant meters. The ability to define green power is also provided. You must be already connected to your customers to be able to manage their meters.
Meter
Method |
REST URI * |
Description |
GET |
/customer/(customerId)/meter/whatChanged?date=(YYYY-MM-DD) |
Returns a list of meters that have been modified since a specified date. |
GET |
/idHierarchy/meter/(meterId) |
Returns the identifiers to the Property Data Administrator (accountId) and property for a specific meter. |
GET |
/meter/(meterId) |
Returns information for a specified meter. The meter must already be shared with you. |
PUT |
/meter/(meterId) |
Updates the information for a specified meter. The meter must already be shared with you and you must have write access to the meter. |
DELETE |
/meter/(meterId) |
Deletes a specified meter. The meter must already be shared with you. |
POST |
/property/(propertyId)/meter |
Adds a meter for a specific property. The property must already be shared with you and you must have write access to the property. |
GET |
/property/(propertyId)/meter/list?myAccessOnly=(myAccessOnly) |
Returns a list of meters for a specified property. The property must already be shared with you. |
GET |
/property/(propertyId)/meter/whatChanged?date=(YYYY-MM-DD) |
Returns a list of meters that have been modified since a specified date, for a specified property. |
Property Meter Association
Method |
REST URI * |
Description |
GET |
/association/property/(propertyId)/meter |
Returns the list of meters that are associated to a given property. The corresponding property must be already shared with you. |
POST |
/association/property/(propertyId)/meter |
Associates a specified list of meters to a given property. The property and meters to associate must be already shared with you. |
POST |
/association/property/(propertyId)/meter/(meterId) |
Associates a specified (single) meter to a given property. The property and meter must be already shared with you. |
DELETE |
/association/property/(propertyId)/meter/(meterId) |
Disassociates a specified meter from a given property. The property and meter must be already shared with you. |
Property-Use Meter Association
Method |
REST URI * |
Description |
GET |
/association/propertyUse/(propertyUseId)/meter |
Returns the list of meters that are associated to a given property use. The corresponding property must be already shared with you. |
POST |
/association/propertyUse/(propertyUseId)/meter |
Associates a specified list of meters to a given property use. The corresponding property and meters must be already shared with you. |
POST |
/association/propertyUse/(propertyUseId)/meter/(meterId) |
Associates a specified (single) meter to a given property use. The property and meter must be already shared with you. |
DELETE |
/association/propertyUse/(propertyUseId)/meter/(meterId) |
Disassociates a specified meter from a given property use. The property and meter must be already shared with you. |
Consumption Data
Method |
REST URI * |
Description |
PUT |
/consumptionData/(consumptionDataId) |
Updates a specific meter consumption data entry. The meter must already be shared with you and you must have write access to the meter. |
DELETE |
/consumptionData/(consumptionDataId) |
Deletes a specific meter consumption data entry. The meter must already be shared with you and you must have write access to the meter. |
GET |
/customer/(customerId)/meter/consumptionData/whatChanged?date=(YYYY-MM-DD) |
Returns a list of meters for a specified customer that have had their consumption data modified since a specified date. |
GET |
/idHierarchy/consumptionData/(consumptionDataId) |
Returns the identifiers to the Property Data Administrator (accountId), property, and meter for a specific consumption data record. |
POST |
/meter/(meterId)/consumptionData |
Adds consumption data and optional demand data to a specified meter. The property that the meter belongs to must already be shared with you and you must have write access to the meter. |
GET |
/meter/(meterId)/consumptionData?page=(page)&startDate=(YYYY-MM-DD)&endDate=(YYYY-MM-DD) |
Returns the consumption data for a specified meter in sets of 120. The meter must already be shared with you. |
DELETE |
/meter/(meterId)/consumptionData?startDate=(YYYY-MM-DD)&endDate=(YYYY-MM-DD) |
Deletes consumption data from a specified meter based on a specified optional date range. The meter must already be shared with you and you must have write access. |
Green Power Offsite
Method |
REST URI * |
Description |
GET |
/offsiteGreenPowerPurchases/(id) |
Returns information for a specific offsite Green Power purchase record. The corresponding property must already be shared with you. |
PUT |
/offsiteGreenPowerPurchases/(id) |
Updates a specific offsite Green Power purchase record. The corresponding property must already be shared with you and you must have write access to the property. |
DELETE |
/offsiteGreenPowerPurchases/(id) |
Deletes a specific offsite Green Power purchase record. The corresponding property must already be shared with you and you must have write access to the property. |
GET |
/property/(propertyId)/offsiteGreenPowerPurchases |
Returns a list of offsite Green Power purchases for a specific property. The corresponding property must already be shared with you. |
POST |
/property/(propertyId)/offsiteGreenPowerPurchases |
Adds an offsite Green Power purchase record to a specific property. The corresponding property must already be shared with you and you must have write access to the property. |
Green Power Onsite
Method |
REST URI * |
Description |
GET |
/meter/(meterId)/onsiteRenewableDetails |
Returns information for all of the onsite Green Power renewable detail records for a specific meter in sets of 1000. You must have access to the meter. |
POST |
/meter/(meterId)/onsiteRenewableDetails |
Adds an onsite Green Power renewable detail record for a specified meter. The meter must already be shared with you and you must have write access to the meter. |
GET |
/meter/(meterId)/onsiteRenewableOptionalInfo |
Returns the additional/optional onsite Green Power renewable detail information for a specific meter. The meter must already be shared with you. |
POST |
/meter/(meterId)/onsiteRenewableOptionalInfo |
Adds additional/optional onsite Green Power renewable detail information for a specific meter. The meter must already be shared with you and you must have write access to the meter. |
PUT |
/meter/(meterId)/onsiteRenewableOptionalInfo |
Updates the additional/optional onsite Green Power renewable detail information for a specific meter. The meter must already be shared with you and you must have write access to the meter. |
GET |
/onsiteRenewableDetails/(id) |
Returns information for a specific onsite Green Power renewable detail record. The meter must already be shared with you. |
PUT |
/onsiteRenewableDetails/(id) |
Updates a specific onsite Green Power renewable detail record. The meter must already be shared with you and you must have write access to the meter. |
DELETE |
/onsiteRenewableDetails/(id) |
Deletes a specific onsite Green Power renewable detail record. The meter must already be shared with you and you must have write access to the meter. |
Waste Data
Method |
REST URI * |
Description |
GET |
/customer/(customerId)/meter/wasteData/whatChanged?date=(YYYY-MM-DD) |
Returns a list of meters for a specified customer that have had their waste data modified since a specified date. |
GET |
/idHierarchy/wasteData/(wasteDataId) |
Returns the identifiers to the Property Data Administrator (accountId), property, and meter for a specific waste data record. |
POST |
/meter/(meterId)/wasteData |
Adds waste data to a specified meter. The property that the meter belongs to must already be shared with you and you must have write access to the meter. |
GET |
/meter/(meterId)/wasteData?page=(page)&startDate=(YYYY-MM-DD)&endDate=(YYYY-MM-DD) |
Returns the waste data for a specified meter in sets of 120. The meter must already be shared with you. |
DELETE |
/meter/(meterId)/wasteData?startDate=(YYYY-MM-DD)&endDate=(YYYY-MM-DD) |
Deletes waste meter data from a specified waste meter based on a specified optional date range. The waste meter must already be shared with you and you must have write access. |
PUT |
/wasteData/(wasteDataId) |
Updates a specific waste data entry. The meter must already be shared with you and you must have write access to the meter. |
DELETE |
/wasteData/(wasteDataId) |
Deletes a specific waste data entry. The meter must already be shared with you and you must have write access to the meter. |
Unique Identifiers
Method |
REST URI * |
Description |
POST |
/meter/(meterId)/identifier |
Adds a meter identifier. The meter must already be shared with you. |
GET |
/meter/(meterId)/identifier/(identifierId) |
Returns the value for a specified meter identifier for a given meter. The meter must already be shared with you. |
PUT |
/meter/(meterId)/identifier/(identifierId) |
Updates the value for a specified identifier for a given meter. The meter must already be shared with you. |
DELETE |
/meter/(meterId)/identifier/(identifierId) |
Deletes the value for a specific identifier for a given meter. The meter must already be shared with you. |
GET |
/meter/(meterId)/identifier/list |
Returns the list of identifier values for a specified meter. The meter must already be shared with you. |
GET |
/meter/identifier/list |
Returns a list of standard and unique identifiers that are currently approved for use by EPA. |
GET |
/property/(propertyId)/meter/identifier/list |
Returns the list of all identifier values for all meters in a specified property. The meters must already be shared with you. |
Meter Aggregation
Method |
REST URI * |
Description |
GET |
/meter/(meterId)/aggregateMeter |
Returns information on whether the specified meter is an aggregate meter that represents multiple individual meters. |
POST |
/meter/(meterId)/individual |
Adds an individual meter to be included in the total for the aggregate meter. The aggregate meter must already be shared with you and you must have write access. |
DELETE |
/meter/(meterId)/individual |
Deletes all information of individual meters that are included in the total for the aggregated meter. The aggregate meter must already be shared with you and you must have write access. |
GET |
/meter/(meterId)/individual/list |
Returns a list of all individual meters that are aggregated into the specified parent meter. The parent meter must already be shared with you. |
GET |
/meter/individual/(individualMeterId) |
Returns information for an individual meter that is included in the total for the aggregate meter. The aggregate meter must already be shared with you. |
PUT |
/meter/individual/(individualMeterId) |
Updates information for an individual meter that is included in the total for the aggregate meter. The aggregate meter must already be shared with you and you must have write access. |
DELETE |
/meter/individual/(individualMeterId) |
Deletes information for an individual meter that is included in the total for the aggregate meter. The aggregate meter must already be shared with you and you must have write access. |
Miscellaneous
Method |
REST URI * |
Description |
GET |
/meter/(meterId)/customFieldList |
Returns a list of your custom fields and their values for a specific meter. |
* For the TEST environment, relative to the base URI: https://portfoliomanager.energystar.gov/wstest
** Web services are only available in the TEST environment.