ENenphase
Site Level Production Monitoring

energy_lifetime

Returns a daily time series of energy produced by the system over its lifetime. All measurements are in Watt hours. The time series includes one entry for each day from the start_date to the end_date with no gaps in the time series. If the response includes trailing zeroes, such as [909, 4970, 0, 0, 0], then no energy has been reported for the last days in the series. If the system has a meter, the time series includes data as measured by the microinverters until the first full day after the meter has been installed. Later, it switches to using the data as measured by the meter. This is called the “merged time series.” The attribute “meter_start_date” indicates the time when the meter measurements begin to be used. You can retrieve the complete time series from the meter and from the microinverters by adding the parameter production=all to the request.

get/api/v4/systems/{system_id}/energy_lifetime

Request

Path parameters

system_idinteger required

The unique numeric ID of the system

Query parameters

start_datestring

Start date of the time series data. Defaults to the system’s operational date. If the start_date is earlier than the system’s operational_date, then the response data begins with the system operational_date as start_date. Pass as String date format YYYY-MM-DD.

end_datestring

End date of the time series data. Defaults to yesterday if start_date is earlier than the system’s current date; it defaults to today if start_date is the current date. Pass as String date format YYYY-MM-DD.

productionstring

When “all”, returns the merged time series plus the time series as reported by the microinverters and the meter on the system. Other values are ignored.

Response

When the query parameters include “production=all”, returns meter and microinverter-measured time series:

system_idinteger

System id

start_datestring

When no start_date parameter is specified on the request, this is the operational_date of the system. May be null if system has never produced. When a start_date parameter is included in the request, it is included here in the response.

meter_start_dateinteger

The first day in the time series when measurements are taken from a meter instead of from microinverters. This field is not present unless the system has a meter.

productioninteger[]

An array of production measurements, one for each day since the system started producing, or one for each day of the requested period. If the system has never produced energy, the array may be empty.

Changes

No recorded changes to this operation across all 2 revisions of this API.