GET /api/tariff/find is a guided funnel. You give it as much as you know, and
it returns two things: the choices still open to you, and — once the funnel
leaves exactly one — the tariff itself.
It never offers a choice that leads nowhere. If an operator has no NE5 tariffs,
NE5 is not in choices.voltages.
The funnel
1
Give it an operator and a year
2
Narrow by grid level and type
choices.tariffs now lists only NE7 electricity tariffs. Each entry already
carries is_eco, is_dynamic and verified, so a picker can be built
without a second request.3
Name one — or don't, if only one remains
tariff is filled in even
without a name. An operator with a single NE3 tariff needs no third click.What you get back
The comparison, and when it is absent
comparison puts the tariff’s energy price against the national median energy
price for an H4 household (4,500 kWh/year).
basis says exactly what was compared. It reads "energy price only" — never a
total bill, because a total depends on the consumption profile and the grid
level, which a named tariff does not carry.