next_update
field, indicating when the tariff data may be refreshed from its source next. This could align with events like market rate publications or scheduled updates from the customer’s energy provider account.
To ensure accuracy, we recommend using the next_update
timestamp to schedule your system’s rate to refresh dynamically. If dynamic scheduling isn’t feasible, you can assume that rates for the following day will typically be updated by 23:00 local time the day before.
start_time
and end_time
are provided in RFC3339 format. This can be in Zulu time (UTC) (e.g. 2023-06-15T13:00:00Z
) or with a time offset, (e.g. 2023-06-15T12:00:00+01:00
).
If you are using offsets and your request spans a period when daylight saving time begins or ends, ensure that both start_time
and end_time
reflect the correct time offset for the location.
When you specify different time offsets, end_time
takes precedence. This maintains consistency in the results. In the tariff rates response, the valid_from
and valid_to
times will all use the end_time
offset that was applied.
Example: