v1

latestOpenAPI 3.0.12026-07-248498266.5 KB

Meters

Retrieve Meter

You can use this endpoint to retrieve the details for a specific meter. If your organization does not have the Intervals product enabled and if the associated account is not activated, you will see limited detailed data returned.

This endpoint supports Sandbox Mode.

get/plug/meters/{meterId}

Path parameters

meterIdstring required

Headers

Arcadia-Versionstring required

The Arcadia-Version for the request

Response

bulbTypestring nullable required

Type or specification of light bulbs associated with the account, if applicable.

correlationIdsstring[] required

A list of correlationIds cascaded from all directly associated Credentials and Files.

createdAtstring date-time nullable required

A timestamp indicating when the entity was created.

createdBystring nullable required

User or system responsible for creating the entity.

customDataPublicCustomDataResource required

You can use these fields to specify additional metadata.

earliestIntervalAtstring date-time nullable required

A timestamp of the earliest interval available for the meter.

generalDescriptionAsPrintedstring nullable required

A general description of the account or service as printed on the bill.

idstring required

A unique identifier for the entity.

isIntervalsDormantboolean nullable required

Indicates whether the meter is dormant based on interval job results and error codes.

isIntervalsProductActiveboolean required

Indicates if intervals is activated for the meter.

isIntervalsThirdPartyPortalMeterboolean required

Indicates whether or not this meter is enrolled under an intervals third party portal.

isLocationRecommendationIgnoredboolean required

Indicates whether or not location recommendation should be ignored.

isStandaloneboolean required

Indicates a meter is not expected to relate to a site.

lastModifiedAtstring date-time nullable required

The timestamp indicating when this resource was last modified.

lastModifiedBystring nullable required

The user or system that last modified this resource.

latestIntervalAtstring date-time nullable required

A timestamp of the latest interval available for the meter

latestIntervalsCheckedAtstring date-time nullable required

A timestamp of the most recent intervals check Arcadia attempted.

latestStatementDatestring date nullable required

The date of the most recent statement.

localTimezonestring nullable required

For meters that have intervals available, the meter's local timezone. The value can be any TZ identifier from this this list.

meterConstantMultipliernumber nullable required

The multiplier used to convert meter readings to actual usage values for the account. The first conversion after the meter delta is calculated

meterNumberstring nullable required

A number assigned to the meter by the commodity provider.

nextExpectedPostDatestring date nullable required

The expected date for the next statement to be posted for this account.

normalizedMeterNumberstring nullable required

The normalized version of the meter number (removing things like hyphens, underscores, and leading zeros).

normalizedPointOfDeliveryNumberstring nullable required

The normalized version of the Point of Delivery number (removing things like hyphens, underscores, and leading zeros).

pipeTypestring nullable required

This field is only populated when the Service Type of the meter is water. This field describes the pipe type

pointOfDeliveryNumberstring nullable required

The point of delivery number in deregulated markets is an independent identifier for meter location and used by all utility companies.

previousMeterConstantMultipliernumber nullable required

The previous multiplier used to convert meter readings to actual usage values.

previousMeterNumberstring nullable required

The number assigned to the previous meter used.

serviceTypestring required

The type of service supported, such as electricity, water, or gas.

serviceTypeClassification'CORE' | 'SUPPLEMENTAL' required

The classification for the service type depending on the comprehensiveness of data that can be returned.

Status of the resource.

Reason the resource has the current status.

voidedAtstring date-time nullable required

A timestamp indicating when the entity was voided. This value resets to null if the entity is unvoided. See event history for additional context.