improved
New API version: 2022-10-13
8 months ago by Clif Reeder
Breaking Changes between 2021-11-17
and 2022-10-13
:
- When fetching utility intervals without using any of the
statement_id
,start_time
, orend_time
parameters, we will now default to fetching the most recently available year's worth of data we have captured. Prior to this change we fetched the most recent year's worth of data ending at the current time, which may have extended past the data's availability. - The
kwh
andis_null_kwh
fields of the interval data body have been removed. Use thenet_kwh
parameter instead. We will not present interval data records if this value isnull
, which makesis_null_kwh
irrelevant. - When requesting utility intervals using explicit
start_time
and/orend_time
parameters, we will now check to see if we have interval data for this time range and error out if we do not. Previously, we would allow these requests but return no utility intervals for uncovered time periods. - When fetching utility intervals or metadata about them using the
utility_account_id
parameter, we will now fail the request if the utility account has multiple associated utility meters. These requests are ambiguous - we do not know which utility meter's utility interval data you are requesting. Please use theutility_meter_id
parameter in this situation instead. - The
master_tariff_id
field/parameter was deprecated in all endpoints. We will no longer accept or return it. Use themain_tariff_id
field/parameter instead.