> ## 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.

# Price a business

> A business's annual bill from its consumption, its peak demand and its grid level — and how far to trust it.

A household's bill needs one number, its annual consumption. A business's needs
three: how much it uses, its highest demand in a month, and whether it is
connected at low or medium voltage. `/api/bundle` composes the bill from the
operator's own tariffs for those three.

## The request

```bash theme={null}
curl "$TARIFF_API/api/bundle?dso=10063012345&period=2027&kwh=150000&kw=50&business=true"
```

| Parameter | Meaning |
| - | - |
| `kwh` | Annual consumption in kWh. |
| `kw` | Peak demand in kW, the figure a power price is billed on. Without it, a power price is named in the bill but left out of the total. |
| `voltage` | Grid level: `7` low voltage (the default), `5` medium voltage. |
| `business` | `true` picks the operator's business products. Below 50'000 kWh a business usually buys the household product — leave it `false` there. |
| `bfs` | Optional: the municipality's BFS number, for an exact community fee where it differs between municipalities. |

ElCom's business categories are a good place to start, since these are the
bills the [accuracy measurement](https://docs.tariffs.nlead.ch/concepts/accuracy.md) checks every night:

| Category | kWh a year | Peak kW | Level |
| - | - | - | - |
| C1 | 8'000 | 8 | 7 |
| C2 | 30'000 | 15 | 7 |
| C3 | 150'000 | 50 | 7 |
| C4 | 500'000 | 150 | 7 |
| C5 | 500'000 | 150 | 5 |
| C6 | 1'500'000 | 400 | 5 |
| C7 | 7'500'000 | 1'630 | 5 |

## The response

Groupe E, C3, as served on 19 November 2026 (abridged):

```json theme={null}
{
  "dso": {"vse_number": "10063012345", "name": "Groupe E SA"},
  "period": 2027,
  "voltage": 7,
  "complete": true,
  "energy_on_open_market": false,
  "lines": [
    {"part": "energy", "tariff_name": "Énergie - Tarif Regulo B horo-saisonnier",
     "rp_kwh": 15.1344, "chf_month": null, "chf_kw_month": null, "stage": "ki"},
    {"part": "grid", "tariff_name": "Utilisation du réseau - Tarif BT Duo",
     "rp_kwh": 3.27, "chf_month": null, "chf_kw_month": 7.8, "stage": "ki"},
    {"part": "metering", "tariff_name": "Tarif de mesure - 1er PM sur compteur basse tension (BT) direct",
     "rp_kwh": null, "chf_month": 74.4, "chf_kw_month": null, "stage": "ki"},
    {"part": "fees", "tariff_name": "Canton de Vaud - Émolument cantonal (art. 19 LSecEl)",
     "rp_kwh": 0.024, "chf_month": null, "chf_kw_month": null, "stage": "ki"},
    {"part": "federal", "tariff_name": null,
     "rp_kwh": 2.85, "chf_month": null, "chf_kw_month": null, "stage": "reference"}
  ],
  "total": {
    "kwh": 150000.0, "kw": 50.0,
    "rp_kwh_energy": 21.28, "rp_kwh_power": 3.12, "rp_kwh_fixed": 3.72,
    "chf_month": 74.4, "rp_kwh": 24.99, "chf_year": 37490.4
  },
  "confidence": {
    "grade": "elcom_confirmed",
    "source": "ai_read",
    "elcom_check": {"category": "C3", "day": "2026-11-19", "dev_pct": 2.87,
                    "cause": "ok", "applies": true, "why_not": null}
  }
}
```

Every part of the bill is a line, with the operator's own tariff name and the
three ways a tariff charges: per kWh (`rp_kwh`, Rp/kWh), per month
(`chf_month`, CHF) and per kW of peak demand per month (`chf_kw_month`, CHF).
`federal` holds the national charges every operator passes on; `stage` says
where each line comes from ([provenance](https://docs.tariffs.nlead.ch/concepts/provenance.md)).

| Total | Meaning |
| - | - |
| `rp_kwh_energy` | Every per-kWh price, summed: energy, grid usage, fees and the national charges. |
| `rp_kwh_power` | The power price on your peak: 7.8 CHF/kW × 50 kW × 12 months over 150'000 kWh is 3.12 Rp/kWh. |
| `rp_kwh_fixed` | Monthly fees and the power price, spread over your consumption. |
| `rp_kwh` | The bill per kWh: `rp_kwh_energy` plus `rp_kwh_fixed`. |
| `chf_year` | The year's bill in CHF, VAT excluded. |

> [!NOTE]
>
> A total is only given when every part has a price. A dynamic energy tariff, or
> a part the operator's sheet leaves empty, gives `complete: false`, names the
> part in `total.unpriced_parts` and keeps `rp_kwh` and `chf_year` at `null`,
> while `rp_kwh_known` still shows what is known.

## Medium voltage and the open market

At medium voltage (`voltage=5`), some operators sell no energy at all (19 of
298 in 2027): their customers there buy it on the open market, and the operator
bills only the grid.
The bill says so instead of looking incomplete:

```bash theme={null}
curl "$TARIFF_API/api/bundle?dso=10783012345&period=2027&kwh=500000&kw=150&voltage=5&business=true"
```

```json theme={null}
{
  "voltage": 5,
  "complete": true,
  "energy_on_open_market": true,
  "lines": [
    {"part": "grid", "tariff_name": "MS", "rp_kwh": 3.2, "chf_month": 40.0, "chf_kw_month": 12.0},
    {"part": "metering", "tariff_name": "Messung Virtuell", "chf_month": 1.0},
    {"part": "fees", "tariff_name": "Gemeindeabgabe", "rp_kwh": 0.6},
    {"part": "federal", "rp_kwh": 2.85}
  ],
  "total": {"rp_kwh": 11.07, "chf_year": 55342.0}
}
```

Add your energy contract's price to `rp_kwh` for the full cost. An operator is
read as selling no energy at medium voltage only where it files no energy
product there and ElCom's figures for its medium-voltage customers have none in
them either. Where it files energy at low voltage only, the bill takes those
products, since the energy is the same.

## How far to trust a business bill

Business bills are harder to get right than household bills. Grid tariffs for
businesses carry power prices and consumption bands, and many operators publish
their business tariffs in separate documents, often read from a PDF by a model.
Today about half of ElCom's business bills come within ±5 %, with a median miss
of 4 to 5 %. For households it is 71 % and 2.2 %
([accuracy](https://docs.tariffs.nlead.ch/concepts/accuracy.md)).

So read each bill's own check:

* `confidence.elcom_check` is last night's comparison of this operator's bill
  for the nearest ElCom category with ElCom's figure. `applies` is `true` when
  your consumption is between 80 % and 125 % of that category's and you chose
  no product yourself.
* `confidence.grade` is `elcom_confirmed` when that check came within ±5 %.
  `ai_read` means a model read the tariffs from a PDF and nothing has confirmed
  them yet.
* `assumptions` names every reading the bill made on your behalf: a fee filed
  as monthly that was a year's amount, the national charges taken out of a grid
  price that already held them, a part filled with ElCom's figure.

> [!WARNING]
>
> Reactive power, network levels above 5, and individual contracts are not in
> these bills. The bill is the published tariff for the consumption you name,
> VAT excluded.


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