Submit Meter Reads Action

Submit customer-provided or field-collected meter readings to an external billing system for billing calculation.

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

Where TOKEN is a variable.

Inputs

Input	Type	Description
`ExternalReferenceIdentifier`	string	Required. External reference ID for this meter read submission.
`ExternalServicePointId`	string	Required. ID of the service point in the external billing system.
`ExternalMeterId`	string	Required. ID of the meter in the external billing system.
`ReadDate`	date	Required. Date the meter reading was taken.
`ExternalContractIdentifier`	string	Optional. ID of the associated contract in the external billing system.
`Readings`	object array[]	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	Type	Description
`registers`	string array[]	Processed register data, returned as JSON strings, one per register.
`externalMeterId`	string	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]