Skip to main content
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

When the funnel leaves exactly one tariff, tariff is filled in even without a name. An operator with a single NE3 tariff needs no third click.

What you get back

Prices are in Rp/kWh here, converted from the operators’ CHF/kWh.

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).
comparison is null whenever a fair comparison does not exist, and this is deliberate rather than a gap:
  • a grid-usage tariff has no energy price;
  • a feed-in tariff is a remuneration, not a price;
  • a dynamic tariff has no fixed rate to compare.
No substitute number is invented for these. If you see null, there is nothing honest to put there.
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. The query string that drives the endpoint is the same one the public map uses, so any point in the funnel is shareable and bookmarkable:

Errors

Looking for the operator’s original document rather than the harmonized reading? source.registered_url is the file the operator itself published, and source.sheet reconstructs the whole tariff sheet in the official VSE submission format.