Meter APIs

Post /api/v3/meter

Operation: CreateMeterV3 Permissions: Meters (Create)

Creates a meter


Get /api/v3/meter

Operation: GetMetersV3 Permissions: Meters (View) Paginated

Retrieves all meters


Get /api/v3/meter/{meterId}

Operation: GetMeterV3 Permissions: Meters (View)

Retrieves one meter


Put Deprecated /api/v3/meter/{meterId}

Operation: EditMeterV3 Permissions: Meters (Edit)

Edits a meter


Delete /api/v3/meter/{meterId}

Operation: DeleteMeterV3 Permissions: Meters (Delete)

Deletes a meter


Put /api/v3/meter/{meterId}/udf

Operation: EditMeterUDFsV3 Permissions: Meters (Edit)

Edits user defined field / custom field values for a particular meter


Get /api/v3/meter/{meterId}/udf

Operation: GetMeterUdfsV3 Permissions: Meters (View)

Retrieves all user defined fields / custom fields for a particular meter


Get /api/v3/meter/udf

Operation: GetMetersUdfsV3 Permissions: Meters (View) Paginated

Retrieves all user defined fields / custom fields for all meters


Get /api/v3/meter/{meterId}/group

Operation: GetMeterGroupsV3 Permissions: Meters (View)

Retrieves all Meter Groups for a particular meter


Put /api/v3/meter/{meterId}/group

Operation: EditMeterGroupMembershipV3 Permissions: BuildingAndMeterGroups (Edit)

Edits a meter’s group memberships.
Note that all groups a meter should belong to must be passed in. Passing in one group means that the meter will belong to one group only,
even if it previously belonged to several.
Only manual groups assignments can be changed; auto groups are unaffected.


Get /api/v3/meter/{meterId}/rate

Operation: GetMeterRatesV3 Permissions: Meters (View)

Retrieves all rates for a particular meter


Get /api/v3/meter/{meterId}/template

Operation: GetMeterTemplatesV3 Permissions: Meters (View)

Retrieves all templates for a particular meter


Get /api/v3/meter/{meterId}/bill

Operation: GetMeterBillsV3 Permissions: BillsAndBatches (View)

Retrieves all bills for a particular meter


Get /api/v3/meter/{meterId}/ghg/factor

Operation: GetGHGMeterFactorsV3 Permissions: Meters (View)

Get the ghg meter factors


Get /api/v3/meter/{meterId}/usevsweather/calendarized

Operation: GetCalendarizedUseVsWeatherDataV3 Permissions: Meters (View)

Get calendarized Use vs Weather data


Put /api/v3/parentPlace/{parentPlaceId}/meter

Operation: MoveMeterV3 Permissions: Meters (Edit)

Move list of meters to be under parentPlaceId


Put /api/v3/meter/{meterId}/serialnumberversion

Operation: EditMeterSerialNumberVersionV3 Permissions: Meters (Edit)


Put /api/v202307/meter/{meterId}/emissionSource

Operation: EditEmissionSourceLinkV202307 Permissions: Meters (Edit)

Edit emission source data on a meter


Put /api/v202307/meter/{meterId}

Operation: EditMeterWithUnitsV202307 Permissions: Meters (Edit)

Edits a meter - unlike the original v3 EditMeter API, the meter use unit will be removed if it is null


Put /api/v202302/meter/{meterId}/watticsDataPoint

Operation: EditWatticsDataPointLinkV202302 Permissions: Meters (Edit)

Edit SmartAnalytics (Wattics) data on a meter


Put /api/v202211/meter/customAction

Operation: ProcessMeterCustomActionV202211 Permissions: Meters (Edit)

Fires a custom meter action. Custom meter actions are setup as webhooks


Get /api/v202203/meter/unplacedMeters

Operation: GetUnplacedMetersV202203 Paginated Permissions: Meters (View)

Get all unplaced meters


Get /api/v202105/meter/{meterId}/udf/{udfId}/download

Operation: DownloadMeterCustomFieldFileV202105 Permissions: Meters (View)

Download file for a meter custom field