/api/1/energy_sites/{site_id}/history
kind
power
or energy
power
selects power statistics, in watts, at 15-minute intervals. energy
selects energy statistics, in kWh, for a specified period.period
day
, week
, month
, or year
kind=power
, the period
parameter is not required, and is ignored if present. When kind=energy
, the period
parameter is required and the value determines the time span of the retrieved data items:day
week
month
year
kind=power
solar_power
value is the power being generated, in watts, at the given timestamp. To save space, only the first entry is shown in the time_series
array. In a real response there are many entries in the array: one entry for each 15 minutes, starting at the beginning (midnight) of the previous day and ending at the current time and day. The entries cover 24 - 48 hours, depending on when the request is made. Depending on your equipment, some nighttime samples may be omitted if they are all zeroes.kind=energy
solar_energy_exported
value is the energy generated by the solar panels, in kWh. To save space, only the first entry is shown in the time_series
array. In a real response there are multiple entries in the array, depending on the value of the period
parameter. For example, if the period
value is week
, there are 7 entries, each one representing the energy generated for one day./api/1/energy_sites/{site_id}/calendar_history
kind
power
or energy
power
selects power statistics, in watts, at 15-minute intervals. energy
selects energy statistics, in kWh, for a specified period.end_date
2022-04-29T14:15:00-07:00
period
day
, week
, month
, year
, or lifetime
end_date
parameter value is "yyyy-mm-ddThh:mm:ss-hh:mm". Specify your local time zone offset for best clarity. Universal time is accepted in the format "yyyy-mm-ddThh:mm:ssZ", but the time is converted to your local time zone, which could also change the date.kind=power
, the period
parameter is not required, and is ignored if present. When kind=energy
, the period
parameter is required and the value determines the time span of the retrieved data items:day
end_date
.week
end_date
.month
end_date
.year
end_date
.lifetime
end_date
.end_date
specifies a time in the middle of the day, then statistics for a partial day are reported when period=day
, but statistics for the entire day are reported when period=week
or period=month
. For period=year
or period=lifetime
, an end_date
in mid-month or mid-year returns statistics for a partial month or partial year.kind=power
solar_power
value is the power being generated, in watts, at the given timestamp. To save space, only the first entry is shown in the time_series
array. In a real response, there is one entry for each 15 minutes, starting at the beginning (midnight) of the specified date and ending at the specified time. To retrieve a full day's records, specify an ending time after sunset, or 23:45:00. Don't use 00:00:00 for the time, or you'll retrieve an empty list.kind=energy
solar_energy_exported
is the energy generated by the solar panels, in kWh. To save space only the first entry in the time_series
array is shown. In a real response, the number of entries in the array depends on the period
and end_date
values. Timestamps in the response represent the start of a period; e.g., monthly statistics for February show a date of February 1st in the timestamp, and daily statistics for February 15th show a timestamp of 1:00 AM on February 15th.