---
title: "List Intervals for a Meter"
method: GET
path: "/plug/intervals/meters/{meterId}"
tags: ["Intervals"]
---

# List Intervals for a Meter

`GET /plug/intervals/meters/{meterId}`

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.

## Path parameters

- `meterId` string, required

## Query parameters

- `startAt` string, date-time
- `endAt` string, date-time

## Headers

- `Arcadia-Version` string, required

## Response `200`

OK

- PublicIntervalResource
  - `correlationIds` string[], required — A list of correlationIds cascaded from all directly associated Credentials.
  - `credentialIds` string[], required — Arcadia generated unique identifier of the credential the meter belongs to.
  - `earliestIntervalAt` string, date-time, required — Timestamp of the earliest interval available for the meter.
  - `electricMeterMultiplier` number, double, required — Multiplier for electric meter (not relevant for non-electric service types).
  - `intervalsCreatedAt` string, date-time, required — Timestamp when intervals were first created for the meter.
  - `intervalsUpdatedAt` string, date-time, required — Timestamp when intervals were last updated for the meter.
  - `isIntervalsDormant` boolean, nullable, required — Indicates whether the meter is dormant based on interval job results and error codes.
  - `latestIntervalAt` string, date-time, required — Timestamp of the latest interval available for the meter.
  - `localTimezone` string, required — Local timezone of the meter. The value can be any TZ identifier from [this list](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List).
  - `meterId` string, required — Arcadia generated unique identifier of the meter
  - `meterNumber` string, required — A number assigned to the meter by the commodity provider.
  - `providerId` string, required — Arcadia generated unique identifier of the utility service provider.
  - `providerName` string, required — The name of the utility service provider.
  - `readType` string, nullable, required — Type of reading (actual, estimated, etc.)
  - `readings` Reading[], required — List of individual interval readings for this meter.
    - `datapoints` Datapoint[], required — List of measurement values in different units
      - `units` string, required — Units of measurement for the value (e.g., kwh, kw, therms, ccf)
      - `value` number, double, required — The measured value in the specified units
    - `direction` string, required — Direction of energy flow (import, export, net)
    - `endAt` string, date-time, required — End time of this interval
    - `kw` number, double, nullable, required — Power usage in kW (deprecated)
    - `kwh` number, double, nullable, required — Energy usage in kWh (deprecated)
    - `startAt` string, date-time, required — Start time of this interval
  - `serviceType` string, required — The type of service supported, such as electricity, water, or gas.

---

[API](https://skmtc.net/arcadia/apis/plug-api.md) · [All operations](https://skmtc.net/arcadia/apis/plug-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arcadia/plug-api/revisions/d00587742116/schema)