Calculate Tariff
Calculate costs for a Tariff.
Executes the calculation pipeline for each tariff component that is active within the requested period. The caller must supply data for every dataset required by the active components, either as inline time_series, persisted profiles, or a combination of both. Dataset names must not overlap between the two inputs.
Authorizations
Query Parameters
When true, the response includes all intermediate pipeline time series (e.g. hourly-power-offtake, monthly-peak) in addition to the final cost. When false (default), only the cost time series is returned per component.
Body
End of the calculation period (exclusive). Must include timezone offset and be after start_time. For correct monthly/daily bucketing, align to local midnight in the tariff's timezone.
Start of the calculation period (inclusive). Must include timezone offset. For correct monthly/daily bucketing, align to local midnight in the tariff's timezone (e.g. 2026-01-01T00:00:00+01:00 for Europe/Stockholm).
ID of the tariff to calculate.
Profile references for datasets. Each entry maps a dataset to a persisted profile UUID. Can be combined with time_series.
Input time series data for each dataset required by the tariff's active components. Can be combined with profiles.
Response
Successful Response
Results per tariff component that is active within the requested period.