The four components
Two consequences worth internalising:
The national charges are the same figure for every operator in the country, so
they are not stored per tariff. For 2026:
Grid levels (Netzebenen)
voltage_level is the grid level the tariff applies to. Three matter here:
A tariff at one level tells you nothing about the same operator’s tariffs at
another, and figures from different levels must never be pooled. Every filtered
endpoint takes
voltage for this reason.
Units
Time windows
Many tariffs are not a single price. ADoppeltarif charges differently by time
of day (HT/NT) and often by season. Those appear as windows:
Flags
tariff_type, tariff_form and customer_type are populated for essentially
every tariff. is_eco is meaningful across the dataset. has_dynamic is
correct where present but describes a very small population — six operators at
NE7 electricity for 2026.Prices that change during the year
Swiss tariffs are fixed for a calendar year, but some operators publish a product’s year as several dated entries: a winter price and a summer price, each with its ownstartDate and endDate. The tariff endpoints return them
as filed.
A composed bill (/api/bundle) treats such entries as one product. The
year’s price is each version’s price weighted by its share of the days, and
the line lists the versions with their dates and prices under versions. For
the bill in force on one day, pass on=YYYY-MM-DD: only the entries valid that
day are used. A new version of an operator’s sheet is a change like any other,
so a webhook subscriber hears of it as tariffs.changed.