POST /api/v202203/utilityPlatform/place/{placeId}/meter

Creates meters on a place from utility platform meter codes

CreateUtilityPlatformMetersByPlaceV202203 Permissions: Meters (Create)
For each meter code: if the meter already exists unplaced, it is moved to the specified place. If the meter does not exist, it is looked up in the Utility Platform and created. Meters already placed on a different building will cause an error.

Request Headers

Header Value Required Description
ECI-ApiKey string Yes Your API key. See Authentication.
Content-Type application/json Yes All requests must specify JSON content type, including the request body.

Path Parameters

Name Description Type Required
placeId Unique numeric identifier of the place to assign meters to integer (int32) Required

Request Body

Array of:

CreateUtilityPlatformMeter
Property Description Type
meterCode The meter code Required Must be between 0 and 32 characters string
Example Request Body application/json 
[
  {    "meterCode": "string"
  }
]

Responses

200 OK The request succeeded and the response body contains the requested data.

Response Body Parameters

Array of:

UtilityPlatformMeter
Property Description Type
active Indicates whether the Meter is Active boolean
commodity CommodityChild
CommodityChild properties
Property Description Type
commodityCode The commodity code Required (defined) string
commodityIcon Icon
Icon properties
Property Description Type
code The icon code Must be between 0 and 64 characters Required when Color is set string
color The icon color Must be between 0 and 32 characters Required when Code is set string
commodityId The commodity identifier Required (defined) integer (int32)
commodityInfo The commodity info Required (defined) string
dataAccessReleaseStatus DataAccessReleaseStatus
DataAccessReleaseStatus properties
Property Description Type
dataAccessReleaseStatusId Id of the Data Access Release Status Possible values are: 1 - Not Applicable 2 - Required 3 - Pending 4 - Released 5 - Declined integer (int32)
dataAccessReleaseStatusInfo Data Access Release Status Information Possible values are: Not Applicable Required Pending Released Declined string
isCalculatedMeter Indicates whether the meter is a calculated meter boolean
isEsaCalculatedMeter Indicates whether the meter is an ESA calculated meter boolean
isSplitChildMeter Indicates whether the meter is a child of a split boolean
isSplitParentMeter Indicates whether the meter is a parent of a split boolean
meterAddress AddressChild
AddressChild properties
Property Description Type
addressTypeId The address type identifier integer (int32)
city The city of the place Must be between 0 and 100 characters string
country The country of the place Must be between 0 and 64 characters string
latitude The latitude of the place Required when the country is not United States or Canada Must be between -90 and 90 Required when Longitude is set number (double)
line1 The line 1 of the address Must be between 0 and 100 characters string
line2 The line 2 of the address Must be between 0 and 100 characters string
line3 The line 3 of the address Must be between 0 and 100 characters string
longitude The longitude of the place Required when the country is not United States or Canada Must be between -180 and 180 Required when Latitude is set number (double)
postalCode The postal code of the place Must be between 0 and 32 characters string
remitTo Remit To field is the name of the person or company who should receive the payment. It’s required for bill pay customers. Must be between 0 and 100 characters string
state The state of the place Must be between 0 and 100 characters string
meterCode The meter code string
meterId The meter identifier integer (int32)
meterInfo The meter info string
meterType MeterTypeChild
MeterTypeChild properties
Property Description Type
meterTypeCode Short code for the meter type (e.g., “ELEC”, “GAS”) string
meterTypeId Unique numeric identifier of the meter type integer (int32)
meterTypeInfo Descriptive name of the meter type string
mostRecentAggregate MostRecentAggregate
MostRecentAggregate properties
Property Description Type
aggregateMeterId The identifier of the aggregate meter integer (int32)
effectiveDate The effective date of the aggregation string (date-time)
serialNumber The meter’s current serial number string
Example Response application/json 
[
  {    "active": false,    "commodity": {      "commodityCode": "string",      "commodityIcon": {},      "commodityId": 1,      "commodityInfo": "string"
    },    "dataAccessReleaseStatus": {      "dataAccessReleaseStatusId": 1,      "dataAccessReleaseStatusInfo": "string"
    },    "isCalculatedMeter": false,    "isEsaCalculatedMeter": false,    "isSplitChildMeter": false,    "isSplitParentMeter": false,    "meterAddress": {      "addressTypeId": 1,      "city": "string",      "country": "string",      "latitude": 1.0,      "line1": "string",      "line2": "string",      "line3": "string",      "longitude": 1.0,      "postalCode": "string",      "remitTo": "string",      "state": "string"
    },    "meterCode": "string",    "meterId": 1,    "meterInfo": "string",    "meterType": {      "meterTypeCode": "string",      "meterTypeId": 1,      "meterTypeInfo": "string"
    },    "mostRecentAggregate": {      "aggregateMeterId": 1,      "effectiveDate": "2026-06-29"
    },    "serialNumber": "string"
  }
]