v1

latestOpenAPI 3.0.12026-07-248498266.5 KB

Intervals

List Intervals for a Meter

The Intervals API endpoint allow you to interact programmatically with the intervals data offering of the Arcadia Platform to retrieve utility provided intervals data for electric meters. This solution allows you to use utility data to conduct granular energy analysis. Use-cases for this include solar/storage modelling and Demand Response programs validation. The intervals data API endpoints delivers up to a year’s historical data initially and then continues to deliver the latest meter readings on an on-going basis as made available the provider.

get/plug/intervals/meters/{meterId}

Path parameters

meterIdstring required

Query parameters

startAtstring date-time

API response returns up to 1 year of interval data from the startAt datetime requested

endAtstring date-time

API response returns up to 1 year of interval data up to the endAt datetime requested

Headers

Arcadia-Versionstring required

The Arcadia-Version for the request

Response

correlationIdsstring[] required

A list of correlationIds cascaded from all directly associated Credentials.

credentialIdsstring[] required

Arcadia generated unique identifier of the credential the meter belongs to.

earliestIntervalAtstring date-time required

Timestamp of the earliest interval available for the meter.

electricMeterMultipliernumber double required

Multiplier for electric meter (not relevant for non-electric service types).

intervalsCreatedAtstring date-time required

Timestamp when intervals were first created for the meter.

intervalsUpdatedAtstring date-time required

Timestamp when intervals were last updated for the meter.

isIntervalsDormantboolean nullable required

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

latestIntervalAtstring date-time required

Timestamp of the latest interval available for the meter.

localTimezonestring required

Local timezone of the meter. The value can be any TZ identifier from this list.

meterIdstring required

Arcadia generated unique identifier of the meter

meterNumberstring required

A number assigned to the meter by the commodity provider.

providerIdstring required

Arcadia generated unique identifier of the utility service provider.

providerNamestring required

The name of the utility service provider.

readTypestring nullable required

Type of reading (actual, estimated, etc.)

serviceTypestring required

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