---
title: "consumption_lifetime"
method: GET
path: "/api/v4/systems/{system_id}/consumption_lifetime"
tags: ["Site Level Consumption Monitoring"]
---

# consumption_lifetime

`GET /api/v4/systems/{system_id}/consumption_lifetime`

## Request

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

Returns a daily time series of energy consumption as measured by the consumption meter installed on the specified system. All measurements are in Watt hours.
 The time series includes one entry for each day from the start_date to the end_date. There are no gaps in the time series. If the response includes trailing zeroes, such as [909, 4970, 0, 0, 0], then no data has been reported for the last three days.

## Path parameters

- `system_id` integer, required

## Query parameters

- `start_date` string
- `end_date` string

## Response `200`

consumption_lifetime

- object
  - `system_id` integer: The unique numeric ID of the system
  - `start_date` string: When no start_date parameter is specified on the request, defaults to the operational_date of the system. May be null if system has never produced. When a start_date parameter is included in the request, the same is included in the response
  - `consumption` integer[]: An array of consumption measurements in Wh, one for each day since consumption metering began, or one for each day of the requested period
  - `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)