> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tariffs.nlead.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# n:lead Swiss Tariffs

> Electricity tariffs for every Swiss distribution grid operator — free to read, no key needed.

Switzerland has roughly 550 distribution grid operators, and every one of them
publishes its own tariffs, in its own format, on its own website. Some publish a
machine-readable file. Most publish a PDF. A few publish a PDF per language.

This service collects those publications, harmonizes them into one shape, and
serves the result over an API that anyone may use.

> [card] [Find one tariff](https://docs.tariffs.nlead.ch/guides/find-a-tariff.md)
>
> Start from an operator and narrow to a single tariff, decomposed into the
> units a reader expects.

> [card] [Filter every operator](https://docs.tariffs.nlead.ch/guides/filter-by-tariff.md)
>
> Start from what a tariff *is* — grid level, type, dynamic, eco — and get
> every operator that publishes one.

> [card] [Take the whole dataset](https://docs.tariffs.nlead.ch/guides/bulk.md)
>
> CSV or newline-delimited JSON, one row per tariff, no pagination.

> [card] [Price by the quarter-hour](https://docs.tariffs.nlead.ch/guides/time-series.md)
>
> Any tariff as a time series, static or dynamic, in one format.

## What you should know before you use it

> [accordion] Not every figure has been checked by a human — and you can always tell which
>
> A tariff read out of a PDF by a model is published alongside one a reviewer
> confirmed line by line. Hiding the unconfirmed ones would blank a third of
> the country. Every tariff carries its provenance, and the answer to "may I
> quote this figure" is in the response.
>
> [How provenance works →](https://docs.tariffs.nlead.ch/concepts/provenance.md)

> [accordion] An empty answer usually means 'nobody offers that', not 'we don't know'
>
> Six operators publish a dynamic household electricity tariff for 2026. Out
> of about 500. Filtered endpoints return the denominator alongside the
> matches so a sparse answer cannot be mistaken for a gap in the data.
>
> [How coverage is reported →](https://docs.tariffs.nlead.ch/concepts/coverage.md)

> [accordion] Prices are in Rp/kWh in the reader-facing endpoints, CHF/kWh in the dataset
>
> The `/api/v1` dataset preserves the operators' own unit, CHF/kWh. The
> reader-facing endpoints convert to Rappen. Both are stated in every
> response; neither includes VAT.
>
> [What is in a tariff →](https://docs.tariffs.nlead.ch/concepts/tariffs.md)

> [accordion] It is free, and staying free depends on you caching it
>
> Reading needs no key and no registration. There is a rate limit of 120
> requests a minute per address, and every response tells you how long its
> answer is good for. Honour the `ETag` and you will rarely meet the limit.
> An integration that needs more, or wants to hear about tariff changes,
> takes an [API key](https://docs.tariffs.nlead.ch/keys.md).
>
> [Caching and limits →](https://docs.tariffs.nlead.ch/limits.md)

> [accordion] How accurate it is, measured every night
>
> Every night each operator's bill for ElCom's standard customers is composed
> from the tariffs held here and compared with ElCom's published figure. The
> result is public, category by category.
>
> [Accuracy →](https://docs.tariffs.nlead.ch/concepts/accuracy.md)

## The shortest useful request

`$TARIFF_API` is the base URL, `https://ch-el-tarif-db.azurewebsites.net` (see the
[quickstart](https://docs.tariffs.nlead.ch/quickstart.md)).

```bash theme={null}
curl "$TARIFF_API/api/tariff/find?\
dso=10117012345&period=2026&voltage=7&type=electricity&name=AEW%20Classic%20Standard-Tarif%20E"
```

```json theme={null}
{
  "tariff": {
    "name": "AEW Classic Standard-Tarif E",
    "energy_rp": 11.4,
    "base_chf_month": 0.0,
    "provenance": {
      "state": "verified",
      "label": "reviewer-validated",
      "note": "a reviewer confirmed these values against the PDF"
    }
  },
  "comparison": {
    "tariff_rp": 11.4,
    "median_rp": 12.11,
    "pct": -5.9,
    "basis": "energy price only",
    "reference": "Swiss median energy price, H4 household, 2026"
  }
}
```

## Where the data comes from

| Source | What it gives | Coverage |
| - | - | - |
| Operators' machine-readable tariff files (VSE format) | The operator's own published figures, unedited | 394 operators for 2027 |
| Operators' tariff PDFs, read by a model | Everything else — many operators publish only a PDF | 327 operators for 2027 |
| Reviewer validation against the source document | Confirmed figures, the highest trust level | 166 operators for 2026; none yet for 2027 |
| ElCom open data (2011→) | The regulator's own published series, for cross-checking | 712 operators in 2011, 537 in 2027 |

> [!NOTE]
>
> Counts are per collection stage and overlap: one operator commonly appears in
> several. Together they cover 527 of the 553 operators for 2027, 99 % of the
> supplied area (19 November 2026). `GET /api/v1/periods` returns the live
> breakdown.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.