---
title: "Retrieves telemetry for all consumption meters for a system"
method: GET
path: "/api/v4/systems/{system_id}/telemetry/consumption_meter"
tags: ["Site Level Consumption Monitoring"]
---

# Retrieves telemetry for all consumption meters for a system

`GET /api/v4/systems/{system_id}/telemetry/consumption_meter`

## Request

- Base URL: `https://api-qa2.enphaseenergy.com`
- URL: `https://api-qa2.enphaseenergy.com/api/v4/systems/{system_id}/telemetry/consumption_meter`
- Auth: none declared
- TypeScript: <https://skmtc.dev/enphase/apis/monitoring-api/docs/api/v4/systems/:system_id/telemetry/consumption_meter/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves telemetry for all the consumption meters of a system. 
If you request a start date earlier than when the system first reported data, we use midnight of the first reported date instead. The first reported date is the later of the system’s First Interval End Date or Interconnection Date.
The end_at is calculated as the minimum of the time of the request and (start time + granularity). 
The meaning of granularity is as follow:
 If granularity is 15mins, maximum 1 interval will appear in response. If granularity is day, maximum 96 intervals, and if granularity is week, maximum 672 intervals,  will appear in response where each interval is of 15 mins duration.
 
 The requested start date must be within 2 years from current date. 
 By default start_at will appear in response. If start_date parameter is passed in the url, then start_date field will appear in response. 
By default end_at will appear in response. If end_date parameter is passed in the url then end_date field will appear in response. Empty list will be returned if the last interval < requested start time < current time.

## Path parameters

- `system_id` integer, required

## Query parameters

- `start_at` integer
- `granularity` '5mins' | '15mins' | 'day' | 'week'

## Response `200`

Telemetry for all consumption meters

- object
  - `system_id` integer: The unique numeric ID of the system
  - `granularity` string: The granularity of the telemetry data. Possible values are 'week', 'day', '15mins', '5mins'. Default is 'day'
  - `total_devices` integer: Number of non-retired consumption meters in the site
  - `start_at` integer: Start Time of the data series. Either Start_date or start_at will be present. By default start_at will appear in response. If start_date parameter is passed in the url, then start_date field will appear in response.
  - `end_at` integer: End Time of the data series. Either end_date or end_at will be present. By default end_at will appear in response. If end_date parameter is passed in the url, then end_date field will appear in response.
  - `items` string: The list key 'intervals'
  - `intervals` object[]
    - `end_at` integer: End time of the telemetry interval
    - `devices_reporting` integer: Number of devices reporting
    - `enwh` integer: Units produced per interval
  - `meta` object: Information about the system such as its status, when it became operational and last reported to Envoy.
    - `status` string: System's status. Corresponding Enlighten values can be found in table added at the end of page.
    - `last_report_at` integer: Timestamp (in epoch format) at which the system's Envoy last submitted a report
    - `last_energy_at` integer: Timestamp (in epoch format) at which the systems's produced energy was last reported. Even if the last produced energy is 0, its timestamp will be returned.
    - `operational_at` integer: Timestamp (in epoch format) at which this system became operational. Corresponds to the system’s interconnect time, if one is specified. Otherwise, it is the system’s first reported interval end time.

## Other responses

- `401`: Authentication Error
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `501`: Not Implemented

---

[API](https://skmtc.dev/enphase/apis/monitoring-api.md) - [All operations](https://skmtc.dev/enphase/apis/monitoring-api/llms.txt) - [OpenAPI document](https://skmtc.dev/enphase/apis/monitoring-api/revisions/a783ff728669?raw)