Submit Meter Reads Action | Energy and Utilities Cloud Developer Guide

This action is available in API version 60.0 and later.

Special Access Rules

The Submit Meter Reads 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/submitMeterReads
Formats: JSON, XML
HTTP Methods: POST
Authentication: Authorization: Bearer token

Inputs

Input	Details
ExternalReferenceIdentifier	Type string Description Required. External reference ID for this meter read submission.
ExternalServicePointId	Type string Description Required. ID of the service point in the external billing system.
ExternalMeterId	Type string Description Required. ID of the meter in the external billing system.
ReadDate	Type date Description Required. Date the meter reading was taken.
ExternalContractIdentifier	Type string Description Optional. ID of the associated contract in the external billing system.
Readings	Type object array[] Description Required. List of register readings. Maximum of 50 items. Each item contains these fields. registerId (string, required) ID of the meter register. readingValue (number, required) Value of the meter reading.

Outputs

Output	Details
registers	Type string array[] Description Processed register data, returned as JSON strings, one per register.
externalMeterId	Type string Description ID of the meter in the external billing system.

Example

POST

This sample request is for the Submit Meter Reads action.

1{
2  "inputs": [
3    {
4      "ExternalReferenceIdentifier": "REF123",
5      "ExternalServicePointId": "SP456",
6      "ExternalMeterId": "MTR789",
7      "ReadDate": "2026-06-01",
8      "Readings": [
9        {
10          "registerId": "REG1",
11          "readingValue": 6512
12        }
13      ]
14    }
15  ]
16}

This sample response is for the Submit Meter Reads action.

1[
2  {
3    "actionName": "submitMeterReads",
4    "errors": null,
5    "invocationId": null,
6    "isSuccess": true,
7    "outputValues": {
8      "externalMeterId": "MTR789",
9      "registers": [
10        "{\"registerId\":\"REG1\",\"readingValue\":6512,\"status\":\"Processed\"}"
11      ]
12    },
13    "sortOrder": -1,
14    "version": 1
15  }
16]