POST waterscope/utility/mobile/metertransfer/preview

Request Information

URI Parameters

None.

Body Parameters

AdminMeterTransferPreviewRequestModel
NameDescriptionTypeAdditional information
FromAccountId

Required. Source account the meter currently belongs to. Must be numeric.

 string

None.
ToAccountId

Required. Destination account to move the meter to. Must be numeric, must exist, and must differ from fromAccountId.

 string

None.
MeterId

Required. Meter (endpoint) identifier to transfer. Must be numeric.

 string

None.
FromDate

Optional. Lower bound of the data window to transfer. Defaults to the meter's registered date when omitted. Cannot be earlier than the registered date, nor later than toDate. Note: the window only scopes which consumption logs migrate; the meter itself moves in full regardless of the dates.

 date

None.
ToDate

Optional. Upper bound of the data window to transfer. Defaults to today when omitted. Must not be earlier than fromDate.

 date

None.

Request Formats

application/json, text/json

Sample: 
{
  "FromAccountId": "sample string 1",
  "ToAccountId": "sample string 2",
  "MeterId": "sample string 3",
  "FromDate": "2026-08-28T08:44:26.336155+00:00",
  "ToDate": "2026-08-28T08:44:26.336155+00:00",
  "AccountId": "sample string 4",
  "UserName": "sample string 5",
  "ProfileIds": [
    "sample string 1",
    "sample string 2"
  ]
}

application/xml, text/xml

Sample: 
<AdminMeterTransferPreviewRequestModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Base.VN.Core.ViewModels.ViewModels.UtilityMobile.AdminMeterTransfer.RequestModel">
  <AccountId xmlns="http://schemas.datacontract.org/2004/07/Base.VN.Core.ViewModels.ViewModels.UtilityMobile.Common">sample string 4</AccountId>
  <ProfileIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns="http://schemas.datacontract.org/2004/07/Base.VN.Core.ViewModels.ViewModels.UtilityMobile.Common">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </ProfileIds>
  <UserName xmlns="http://schemas.datacontract.org/2004/07/Base.VN.Core.ViewModels.ViewModels.UtilityMobile.Common">sample string 5</UserName>
  <FromAccountId>sample string 1</FromAccountId>
  <FromDate>2026-08-28T08:44:26.336155+00:00</FromDate>
  <MeterId>sample string 3</MeterId>
  <ToAccountId>sample string 2</ToAccountId>
  <ToDate>2026-08-28T08:44:26.336155+00:00</ToDate>
</AdminMeterTransferPreviewRequestModel>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'AdminMeterTransferPreviewRequestModel'.

Response Information

Resource Description

AdminMeterTransferPreviewResponseModel
NameDescriptionTypeAdditional information
MeterId

Meter (endpoint) identifier.

 string

None.
IsValid

Whether the meter exists under the source account and is eligible to transfer.

 boolean

None.
IsMeterExists

Whether the meter currently exists (under the source account / not owned by another account).

 boolean

None.
ResolvedFromDate

The lower bound that the transfer would actually use after default resolution (VR-6).

 date

None.
ResolvedToDate

The upper bound that the transfer would actually use after default resolution.

 date

None.
ResponseCode

Application result code: 0 = Success, 1 = Error. Separate from the HTTP status code — a business failure is still returned as HTTP 200 with responseCode 1, so check both.

 integer

None.
Message

Gets or sets the message.

 string

None.

Response Formats

application/json, text/json

Sample: 
{
  "MeterId": "3003008",
  "IsValid": true,
  "IsMeterExists": true,
  "ResolvedFromDate": "2023-06-24T00:00:00",
  "ResolvedToDate": "2026-06-18T00:00:00",
  "ResponseCode": 0,
  "Message": "Success"
}

application/xml, text/xml

Sample: 
<AdminMeterTransferPreviewResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Base.VN.Core.ViewModels.ViewModels.UtilityMobile.AdminMeterTransfer.ResponseModel">
  <Message xmlns="http://schemas.datacontract.org/2004/07/Base.VN.Core.ViewModels.ViewModels.UtilityMobile.Common">Success</Message>
  <ResponseCode xmlns="http://schemas.datacontract.org/2004/07/Base.VN.Core.ViewModels.ViewModels.UtilityMobile.Common">0</ResponseCode>
  <IsMeterExists>true</IsMeterExists>
  <IsValid>true</IsValid>
  <MeterId>3003008</MeterId>
  <ResolvedFromDate>2023-06-24T00:00:00</ResolvedFromDate>
  <ResolvedToDate>2026-06-18T00:00:00</ResolvedToDate>
</AdminMeterTransferPreviewResponseModel>