improved

New API version: 2022-10-13

Breaking Changes between 2021-11-17 and 2022-10-13:

  • When fetching utility intervals without using any of the statement_id, start_time, or end_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 and is_null_kwh fields of the interval data body have been removed. Use the net_kwh parameter instead. We will not present interval data records if this value is null, which makes is_null_kwh irrelevant.
  • When requesting utility intervals using explicit start_time and/or end_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 the utility_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 the main_tariff_id field/parameter instead.