Get Meter Readings from Billing System Action

Retrieve historical meter readings for a service point from an external billing system for analysis and billing verification.

This action is available in API version 60.0 and later.

Special Access Rules

The Get Meter Readings from Billing System action is available in Enterprise and Unlimited Editions with Energy and Utilities Cloud. The org must have an external billing system integration configured.

Supported REST HTTP Methods

URI: /services/data/v60.0/actions/standard/getMeterReadingsFromBillingSystem

Formats: JSON, XML

HTTP Methods: GET

Authentication: Authorization: Bearer TOKEN

Where TOKEN is a variable.

Inputs

Input	Type	Description
`ExternalServicePointId`	string	Required. ID of the service point in the external billing system for which meter readings are retrieved.

Outputs

Output	Type	Description
`meterReadings`	string[]	List of JSON strings, each containing one meter reading, including read date, reading value, unit of measure, and register ID.

Example

GET

This sample request is for the Get Meter Readings from Billing System action.

1{
2  "inputs": [
3    {
4      "ExternalServicePointId": "SP456"
5    }
6  ]
7}

This sample response is for the Get Meter Readings from Billing System action.

1[
2  {
3    "actionName": "getMeterReadingsFromBillingSystem",
4    "errors": null,
5    "invocationId": null,
6    "isSuccess": true,
7    "outputValues": {
8      "meterReadings": [
9        "{\"readDate\":\"2026-05-01\",\"reading\":5432,\"uom\":\"kWh\",\"registerId\":\"REG1\"}",
10        "{\"readDate\":\"2026-06-01\",\"reading\":6512,\"uom\":\"kWh\",\"registerId\":\"REG1\"}"
11      ]
12    },
13    "sortOrder": -1,
14    "version": 1
15  }
16]